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Business Analytics 



Objectives 

■ At the end of this module, you should be able to: 

■ identify the dimensions associated with a fact table 

■ identify conformed vs. non-conformed dimensions 

■ create star schema groupings to provide authors 
with logical groupings of query subjects 

■ rapidly create a model using the Model Design 
Accelerator 
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Business Analytics 
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This module teaches how to create a presentation view consisting of logical groupings 
of query subjects (facts and their related dimensions) that focus on various areas of the 
business. 
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Business Analytics 



Create a Presentation View Hcco 



■ Provide a logical and 
simplified presentation 
of metadata and 
reporting tools for 
report authors. 



GO Operational Model 
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A large part of your goal as a metadata modeler is to create a simplified view for report 
authors. This can be done by presenting the metadata in a logical manner and providing 
authors with commonly used tools such as filters or calculations. 

The Presentation View in the slide example consists of shortcuts to Consolidation View 
model query subjects, arranged in star schema groupings (a fact query subject and all its 
related dimensions). 

Generally, the Consolidation View and Foundation Objects View are hidden from 
report authors. 

You do not have to model and present as a star schema. For example, if your model is 
designed to satisfy only a certain set of pre-built reports from which authors cannot 
stray, then you can model your metadata to that specific end. However, if you are 
modeling to a broader and largely ad hoc audience, then modeling as a star schema is 
an excellent choice for achieving predictable results. 
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Business Analytics 



Populate the Presentation View 

Recommendation #10 

■ Use star schema grouping wizard 
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The Create Star Schema Grouping wizard creates logical groupings of central fact tables 
and their related dimensions. These groupings consist of shortcuts to the underlying 
objects and are placed in a namespace so that the same dimension names can occur in 
other star schema groupings. This allows authors to identify conformed dimensions. 

As you model, you should document your logical groupings with a dimension map. 

You can then use the dimension map to quickly create your star schema groupings. 

In the slide example, the objects on the left are model query subjects in the 
Consolidation View, which are based on objects in the Foundation Objects View. The 
model query subjects are related to each other in the Foundation Objects View 
(represented by the dashed lines in the diagram above). These objects are then grouped 
for presentation as shown on the right side of the diagram. 
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Business Analytics 



Identify Conformed Dimensions 



Based on matching names 

Must use at least one 
conformed dimension to 
report across facts to: 

■ allow for stitch queries 

■ ensure correct aggregation 
for each fact 



n GO Operational (quef y) 



3 



I Sales (query) 

± : yjfl Sal«Fact 
+i Dog Branch by Location 
+ Order Codes 
Si m Qrdfr Wfethod 
i nns] Products 
4 0]] by location 

Q]] Staff by Location 
Time 



+j 

zJ 



+ HQ Time (Close) 

±j m Tiirie (Ship) 
Returns (query) 

Sales Targets (query) 
+i DQS Sales Target Fact 



00] Products 
yg Retfljgr by location 



4 Q]] Sales Target by Location 

+ 



DOB staff by Location 
Time 



• • • 



Cognos 

software 



>2010 IBM Corporation 



Modelers and authors can quickly identify conformed dimensions in the Presentation 
View based on naming conventions. If designed correctly, dimensions with the exact 
same name in different namespaces are shared between the facts. 

Dimensions that are not shared between facts (non-conformed) can still be used in 
multi- fact queries providing at least one conformed dimension is used. 
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Demo 1 : Create the Presentation View 



Purpose: 

To present report authors with an intuitive view of the metadata, you 
will create a view based on star schema groupings of your relational 
metadata. You will use the dimension map provided to you to easily 
create these groupings. You will then create a package specific to 
your new view, publish it, and test it. 



Components: Framework Manager, Business Insight Advanced 

Project: GO Operational 

Package: GO Operational (query) 

Task 1 . Use star schema groupings to populate the 

Presentation View. 

1. In Framework Manager, close any projects that may be open, and then open 

the GO Operational project located at C:\Edcognos\B5152\ 
CBIFM-Start Files\Module 12\GO Operational. 

2. In the Project Viewer pane, under the GO Operational Model namespace, 
create a new namespace called Presentation View, and then drag it above the 
Consolidation View namespace. 

The results appear as follows: 



Project Viewer 


3 -11 GC 

+ 

+]■ 


>0| 

GC 

IS 


pe rational 

' Operational Model 
Presentation View 
Consolidation View 
Foundation Objects View' 



12-8 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 







CREATE THE PRESENTATION VIEW 



3. In the Presentation View namespace, create a new namespace called GO 

Operational Sales (query). 

The (query) suffix in this case indicates that these objects are stricdy relational 
items and not dimensionally modeled relational (DMR) objects. DMR objects 
will be created in a later module. 

You will populate this new namespace with star schema groupings of your 
Consolidation View model query subjects. 

4. In the Consolidation View, select Sales Fact and all its related dimensions 
identified in your B5152-Requirements_handout sheet. 

5. Right-click on one of the selected objects, and then click Create Star Schema 
Grouping. 

6. Change the Namespace name to Sales (query), and then click OK. 

7. Drag the new namespace into the GO Operational Sales (query) namespace 
in the Presentation View. 
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8 . 
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Expand Sales (query). 



The results appear as follows: 



Presentation View 



^ GO Operational Sales {query] 



^ 3 1 Sales (query) 

^|| Sales Fact 

Branch by Location 
Order Codes 
ggg Order Method 
^ Products 

Retailer by Location 
Staff by Location 
Time 

Time (Dose) 
god Time {Ship) 



Note that all the model query subjects are shortcuts to the ones in the 
Consolidation View. You have simply grouped the ones needed for sales 
queries in one place. 



If the dimensions are not listed alphabetically, you can use the Reorder feature 
to sort them and then drag Sales Fact to the top for easy access. 
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VIEW 



9. Repeat steps 4 to 8 for the following fact query subject: 



• Returns Fact - Namespace name — Returns (query) 



The results appear as follows: 



^ Presentation View 



^ GO Operational Sales {query] 



Sales (query) 

3g Sales Fact 

Branch by Location 
|35 Order Codes 
|35 Order Method 
Products 

j---|55 Retailer by Location 
§5 Staff by Location 
§1 Time 
|jj] Time {Oose) 

g|H ( Sh 'Pl 

Returns (query) 

Returns Fact 
Branch by Location 
Order Codes 
35 Order V:ethod 
Products 

35 Retailer by Location 
Return Reason 
Staff by Location 
Time 



The conformed dimensions are clearly visible (such as Products and Staff by 
Location). This allows authors to create queries across sales and returns facts. 

Important note: If you encounter any problems with these groupings during 

your testing, you will need to trace back to the Foundation 
Objects View to ensure all the proper relationships are in 
place and that there are no unresolved reporting traps. 
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Task 2. Make model filters available to report authors. 



You will now make the Retailer Location Filters available in the Presentation View by 
using a shortcut. 



1 . 



2 . 



In the Consolidation View, expand Model Filters, right-click Retailer 
Location Filters, point to Create, and click Shortcut. 

Move the shortcut to the GO Operational Sales (query) namespace, and then 
rename it to Retailer Location Filters. 

The results appear as follows: 



‘o' Presentation View 



GO Operational Sales (query) 



Sales (query) 

^ Sales Fact 
!■■■■ fjjjfj Branch by Location 
|gg Order Codes 
Order Method 
Products 

^j]j Retailer by Location 
|gj Staff by Location 

m Time 

Time Dose; 

H Time (Ship) 



Returns (query) 

^11 Returns Fact 
|- Branch by Location 
^gg Order Codes 
ggg Order Method 
^ Products 

i--£gB Retailer by Location 
Sgl Return Reason 
ggg Staff by Location 
S3 Time 

Retailer Location Filters 



3. Save the project. 
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Task 3. Create and publish a Presentation View package. 



You will create a new package containing just the metadata that was modeled for 
report authors. 



1 . 

2 . 

3. 

4. 




Right-click Packages, point to Create, and then click Package. 

In the Name box, type GO Operational (query), and then click Next. 

Clear GO Operational Model, expand Presentation View>GO Operational 
Sales (query). 



Select all children of GO Operational Sales (query) as shown below: 



X Ell^gl GO Operational Model 
X Presentation View 

a- xHPBl GO Operational Sales {query) 

j-EhIH Sales (query) 

+ ✓ klfj Returns (query) 

si d£i Retailer Location Filters 



X M ‘B Consolidation View 



X k ^ Foundation Objects View 



Click Finish. 



You are prompted to open the Publish Package wizard. 

6. Click Yes. 

7. Clear the Enable model versioning check box, click Next twice, and then 
click Publish. 



Tip: You can open IBM Cognos Connection from this dialog in order to 
quickly view and test your work. 

8. Click Yes, and then click Finish. 

The Verify Model dialog box appears listing informational messages that 
indicate underlying objects will be published with the package but hidden from 
authors. This is necessary as IBM Cognos will require information from these 
items to properly generate queries. 
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9. Click Close, and then save and close the project. 

Results: 

By using star schema groupings to populate the Presentation View, 
you have created an easy-to-understand view of the metadata that 
follows two simple rules: 

1. When writing queries, use associated dimensions and facts 
(these are logically grouped using namespaces). 

2. When writing multi-fact queries, use at least one conformed 
dimension, which can be identified by naming conventions. 
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Workshop 1 : Create the Presentation View 



Using the Star Schema Grouping wizard, you will create a logical grouping for sales 
target information. 

To accomplish this, you will: 

• Select Sales Target fact in the Consolidation View and all its related 
dimensions (use the dimension map provided) 

• Use the Star Schema Grouping wizard to create a new namespace called Sales 
Targets (query) containing the selected items 

• Move the new namespace to the GO Operational Sales (query) namespace 
below Returns (query) 

• Update the GO Operational (query) package to include the new namespace 

• Publish the package and test the Sales Target (query) in Query Studio with the 
following items: 

• Sales Target by Location>Sales Target Country 

• Sales Target Fact>Sales Target 

An error message is returned. Return to the Project to resolve the issue and then close 
the browser to clear the cache memory before testing. Retest the package in Query 
Studio. 

For more detailed information outlined as tasks, see the Task Table on the next page. 

To see the desired filters, see the Workshop Results section that follows the Task 
Table. 
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Workshop 1: Task Table 



Task 


Where to Work 


Hints 


1 . Create star schema 
grouping for sales 
targets. 


Project Viewer, 
Star Schema 
Grouping wizard 


• In the Consolidation View, select 
Sales Target Fact and all related 
dimensions identified in your 
dimension map handout 

• Call the new namespace Sales 
Target (query) 

• Move the new namespace to the 
GO Operational (query) located in 
the Presentation View namespace 
and place below Returns (query) 


2. Update GO 

Operational (query) 
package and 
publish. 


Project Viewer, 
Package Definition 


• Open the GO Operational (query) 
package definition 

• Select the Sales Targets (query) 
namespace under GO Operational 
(query) 

• Publish the package 
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Task Where to Work Hints 

3. Test Sales Targets IBM Cognos • Launch IBM Cognos Connection 

(query) objects in Connection, 

Query Studio. Query Studio • Launch Query Studio selecting the 

GO Operational (query) package 

• Add the following items to the 
report: 

• Sales Target by Location>Sales 
Target Country 

• Sales Target Fact>Sales Target 

• Read the error message and then 
return to Framework Manager and 
investigate in the Foundation 
Objects View (working your way 
backwards from the Consolidation 
View) 

• Recreate missing relationship, 
publish package again, and then 
test in Query studio 

• Close the browser, without saving 
and close with saving changes in 
Framework Manager 
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Workshop 1 : Workshop Results 



Once you have created your Sales Targets (query) star schema grouping, the 
Presentation View should appear as shown below: 



^§1 Presentation View 



^ GO Operational Sales (query) 



Sales (query) 



Returns (query) 

- Sales Targets (query) 

Sales Target -act 
^ Products 

Retailer by Location 
Sales Target by Location 
Staff by Location 
§fi3 Time 

Retailer Location Rlters 



Once you have updated the GO Operational (query) package definition it should 
appear as shown below: 



□■■■ X t GO Operational Model 



B- X HllWI Presentation View 



□■■■ X t pg GO Operational Sales (query) 



S- k Sales (query) 



El " >/ bl ^ Returns (query) 

Sales T arget (query) 
4ZE» Retailer Location Filters 



E - X Consolidation View 



0- X ▼ Foundation Objects View 
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Workshop 1 : Workshop Results 



After testing the Sales Targets (query) items, your error message should appear as 
shown below: 
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Workshop 1 : Workshop Results 



After investigating the Foundation Objects View (working you way backwards from 
the Consolidation View), you should see a missing relationship in the Diagram between 
COUNTRY and SALES TARGET as shown below: 




The relationship was accidentally deleted during the modeling process. 
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Workshop 1 : Workshop Results 



After you recreate the relationship, publish the package and test in Query Studio, your 
report should appear as shown below: 



Sales Target Country Sales Target 


Australia 


98,545,000 


Austria 


128,744., 500 


Belgium 


101,979,100 


Brazil 


123,728,500 


Canada 


272,116,900 


China 


286,772,000 


Denmark 


55,215,000 


Finland 


169,332,500 


France 


257,675,400 


Germany 


235,055,620 


Italy 


167,696,700 


Japan 


318,688,170 


Korea 


180,729,100 


Mexico 


149,668,200 


Netherlands 


165,116,400 


Singapore 


177,137,700 


Spain 


149,005,900 


Sweden 


86,559,000 


Switzerland 


90,307,000 



The report works and returns results as expected. 
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Business Analytics 

Model Design Accelerator 

■ The Model Design Accelerator is a graphical utility 
designed to guide modelers through a simplified 
modeling process. 
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The Model Design Accelerator is a graphical utility designed to guide both novice and 
experienced modelers through a simplified modeling process. The Model Design 
Accelerator applies IBM Cognos best practices to quickly produce single star schemas. 

Multiple star schemas can be created using the Model Design Accelerator several times 
and linking the results together. Additional features can be added to the model using 
standard Framework Manager functionality. 
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Demo 2: Rapidly Create a Model using the Model Design 

Accelerator 



Purpose: 

A senior manager wants to create reports about returned products 
to review returns data by product, customer, and return reason. 
Since this project has a limited scale, you will use the Model Design 
Accelerator to quickly produce a package for reporting. 

A data warehouse has been created and will be used as it is better 
suited for reporting and ease of modeling. 



Component: Framework Manager 

Project: GO Returns 

Task 1. Start the Model Design Accelerator and import data. 

1. In Framework Manager, close any projects that may be open. 

2. Click Create a new project using Model Design Accelerator. 

The New Project dialog opens. 

3. Navigate to C:\Edcognos\B5152\Course_Project in the Location box, and 
then click OK 

4. In the Project name box, type GO Returns. 

The GO Returns folder is created by default and appears by default in the 
Location box. 

5. Click OK 

The Select Languages dialog box appears. Set the default and design language 
for this project as English. 

6. Ensure that English is selected, and then click OK. 

The Metadata Wizard appears. 
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7. Select the great_outdoors_warehouse data source. 

8. In the list of objects, expand GOSALESDW>Tables. 

9. Select the following tables: 

DIST_RETURNED_ITEMS_FACT 

DIST_RETURN_REASON_DIM 

SLS_PRODUCT_DIM 

SLS_PRODUCT_LINE_LOOKUP 

SLS_PRODUCT_ LOOKUP 

SLS_PRODU CT_TYPE_LOOKUP 

SLS_RTL_DIM 

10. Click Continue. 

The IBM Cognos Framework Manager User Guide window opens, displaying 
information about the Model Design Accelerator. 

The information in this window explains the steps to create a model using the 
Model Design Accelerator. 

11. Close the IBM Cognos Framework Manager User Guide. 

Task 2. Create a Returns fact table. 

1 . In the Model Accelerator pane, right-click the Fact Query Subject in the 
center of the pane and click Rename. 

2. Type Returns Fact to rename the fact query subject. 

3. Press Enter. 

4. In the Explorer Tree pane, expand the 

DIST_RETURNED_ITEMS_FACT table. 

5. Drag the RETURN_QUANTITY data item into the Returns Fact query 
subject. 
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Task 3. Create a Product Dimension Table. 

1. Rename New Query Subject 1 to Products. 

2. In the Explorer Tree pane, expand the SLS_PRODUCT_LINE_LOOKUP 

table. 

3. Drag the PRODUCT_LINE_EN data item into the Products query subject. 

4. Expand the SLS_PRODUCT_TYPE_LOOKUP table. 

5. Drag the PRODUCT_TYPE_EN data item into the Products query subject. 

6. Expand the SLS_PRODUCT_LOOKUP table. 
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7. Drag the PRODUCT_ NAME data item into the Products query subject. 
The Relationship Editing Mode for: Products dialog opens. 




This dialog opens because Framework Manager cannot determine the 
relationship between the SLS_PRODUCT_LOOKUP table and the 
DIST_RETURNED_ITEMS_FACT table. You will need to establish the 
relationship yourself. 

8. C trl-click SLS_PRODUCT_LOOKUP>PRODUCT_NUMBER and 
SLS PRODUCT DIM>PRODUCT NUMBER. 
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9. In the Relationship Editing Mode window, click Create a Model 



Relationship between these Columns 

dialog. 

The Modify the Relationship dialog opens. 




in the top left comer of the 



10. From the Relationship Cardinality drop-down list, select One to Many. 



The SLS_PRODUCT_ LOOKUP table has an entry for each product for each 
language. This results in a one-to-many relationship with the PRODUCT table. 
Once you finish generating the basic model, you will add a filter to filter out all 
non-English product names, thus creating a one-to-one relationship. 

1 1 . Click OK, and then click OK again. 



Task 4. Create a Retailer Dimension Table. 



1. Rename New Query Subject 2 to Retailers. 

2. In the Explorer tree pane, expand the SLS_RTL_DIM table. 

3. Drag the RETAILER_TYPE_EN and RETAILER_NAME data items 
into the Retailers query subject. 

4. Double-click the Retailers table. 

5. Double-click the link between the SLS_RTL_DIM and 
DIST_RETURNED_ITEMS_FACT tables. 

Notice how the link between the tables is based on RETAILER_SITE_KEY. 
The Model Design Accelerator creates this join for you. 

6. Click Close, and then close the Query Subject Diagram: Retailers window. 
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Task 5. Create a Return Reason Dimension Table. 

1. Rename New Query Subject 3 to Return Reason. 

2. In the Explorer tree pane, expand the DIST_RETURN_REASON_DIM 
table. 

3. Drag the REASON_DESCRIPTION_EN data item into the Return 
Reason query subject. 

4. Right-click New Query Subject 4 and press Delete. 

5. Click Generate Model, then click Yes. 

The Model Design Accelerator creates a model for you based on your 
selections. 

Task 6. Add a filter to the model. 

1 . Expand the Model namespace in the Project Viewer. 

2. Expand the Physical View namespace. 

3. Expand the GOSALESDW namespace. 

4. Double-click the SLS_PRODUCT_ LOOKUP table. 

The Query Subject Definition window opens. 

5. Click the Filters tab, and then click Add. 

6. Type Language Filter in the Name text box. 

7. Drag the PRODUCT_LANGUAGE data item from the Available 
Components pane to the Expression box. 

8. After PRODU CTJLAN GUAGE type =’EN\ 

9. Click OK, click the Test tab, and then click Test Sample in the bottom right 
of the window. 

All the values in the PRODU CT_LAN GUAGE column should read "EN." 

10. Click OK 
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Task 7. Create a GO Returns package. 

1 . In the Project Viewer, right-click Packages, point to Create and then click 
Package. 

2. Type GO Returns in the Name text box. 

3. Click Next. 

4. Click the green check mark beside the Model namespace. 

All the green check marks turn to red x's. 

5. Expand the Presentation View namespace. 

6. Change the red x beside Returns Fact, Products, Retailers, and Return 

Reason tables to green check marks. 

7. Click Finish. 

8. Click Yes. 

9. Clear the Enable model versioning check box, accept the remaining defaults, 
and then click Next. 

10. On the Add Security page, click Next. 

1 1 . Clear the Verify the package before publishing check box, and then click 
Publish. 

12. Click Finish to close the wizard, and then save the project. 

Task 8. Test the GO Returns package. 

1 . Log in to IBM Cognos Connection using username admin and password 

Educationl!. 

2. Click Author Business Reports. 

3. Click the GO Returns package. 
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4 . 

5 . 

6 . 

7 . 

8 . 

9 . 

10 . 

11 . 

12 . 

13 . 

14 . 

15 . 



Click Create new, and then double-click List. 

Expand the Retailers query subject. 

Drag the RETAILER NAME data item into the workspace. 

Expand the Return Reason query subject. 

Drag the REASON_DESCRIPTION_EN data item into the workspace to 
the right of RETAILER_NAME. 

Expand the Products query subject. 

Drag the PRODU CT_LINE_EN data item into the workspace to the right 



of REASON DESCRIPTION EN. 



Expand the Returns Fact query subject. 

Drag RETURNQUANTITY into the workspace to the right of 

REASON DESCRIPTION EN. 



Select the RET AI LE R NAME column header in the workspace. 



Click the Group 



I 



button in the toolbar. 



Close all browser windows, save the project and then close Framework 




Results: 

The senior manager can now review returns data by return reason, 
retailer, and product. The model and package were created in much 
less time than it would have taken had you not used the Model 
Design Accelerator. 
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Business Analytics 

Summary 

■ You should now be able to: 

■ identify the dimensions associated with a fact table 

■ identify conformed vs. non-conformed dimensions 

■ create star schema groupings to provide authors 
with logical groupings of query subjects 

■ rapidly create a model using the Model Design 
Accelerator 

Cognos 

software 
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Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ identify key differences and make 
recommendations for using data source, model, 
and stored procedure query subjects 

■ identify the effects on generated SQL when 
modifying query subjects, SQL settings and 
relationships 



Cognos 

software 
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Business Analytics 

Compare Query Subject Types 

■ Three types of query subjects: 

■ data source 

■ model 

■ stored procedure 

■ Each can be foundation model objects used to create: 

■ regular and measure dimensions 

■ various business views 

Cognos. 

software 

©2010 IBM Corporation 



Data source query subject - maps to a corresponding object in the data source and uses 
a modifiable SQL statement to retrieve the data 

Model query subject - maps to existing metadata in the model 

Stored procedure query subject - executes a database stored procedure to retrieve or 
update data 
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Business Analytics 






E = == 


Data Source Query Subjects 




■ Data source query 
subjects are: 

■ generated from an 
SQL statement 

■ generally a simple, 
all-inclusive SQL 
statement 


Select 

ORDER_HEADER.RETAILER_SITE_CODE, 

ORDER_HEADER.RETAILER_CONTACT_CODE, 

ORDER_HEADER.SALES_STAFF_CODE, 

ORDER_HEADER.SALES_BRANCH_CODE, 

ORDER_HEADER.ORDER_METHOD_CODE, 

ORDER_DETAILS.PRODUCT_NUMBER, 

RETU RNED_ITEM. RETU RN_CODE, 

RETU RNED_ITEM. RETU RN_DATE, 

RETU RNED_ITEM . ORDE R_DETAIL_CODE, 
RETU RNED_ITEM . RETU RN_REASON_CODE, 
RETU RNED_ITEM . RETU RN_QUANTITY 

from 


Modified 

SQL 

statement 


■ modifiable 

SQL statement after import 


[GOSL] . RETU RN E D_ITE M, 
[GOSL].ORDER_HEADER ORDER_HEADER, 
[GOSL].ORDER_DETAILS ORDER_DETAILS 

where 






Select * from [G OSL] . RETU RN E D_ITE M 


Q 


RETU RNED_ITEM . ORDE R_DETAIL_CODE = 
ORDER_DETAILS.ORDER_DETAIL_CODE 






and 

ORDER_HEADER.ORDER_NUMBER = 
ORDER_DETAILS.ORDER_NUMBER 


Cognos 

software 
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The SQL that is found on the SQL tab of a Query Subject Definition dialog populates 
the query item list, defines the scope of the query subject, and generates runtime SQL. 

You can modify the SQL as required, to generate SQL that meets specific needs. You 
can also implement parameter driven dynamic SQL. 

Alter the simple select statements as lithe as possible to generate the most efficient SQL 
and simplify model maintenance. 

In the slide example we see the RETURNED_ITEM data source query subject SQL 
after import. It is a simple, all-inclusive select statement. If you do not alter this SQL 
and new columns are added to the table, they will be automatically reflected in 
Framework Manager when you update the query subject or test it. If you modify the 
SQL as seen on the right side of the slide example, new columns will not be reflected, 
and will need to be added manually in the SQL statement. As stated, sometimes 
customized SQL is required for a specific application. 
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Business Analytics 

Set SQL Type 

■ You can set the SQL type for data source query 
subjects. 

■ SQL Type setting includes: 

■ Cog nos 

■ Native 

■ Pass-Through 



Cognos, 

software 
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SQL settings can be specified from the Options link inside the Query Subject 
Definition dialog box or by enclosing your select statement in {} for native SQL and 
{ {} } for pass-through SQL. 

This setting is local to the query subject and impacts how a table-based query is defined 
and used in query generation. 
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Business Analytics 

SQL Type: Cognos SQL 

■ Adheres to SQL standards 

■ Can contain metadata from multiple data sources 

■ Has fewer database restrictions 

■ Works with all relational and tabular data sources 

■ Is portable 



Cognos. 

software 
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If you need to port your model from one vendor to another, use Cognos SQL since it 
works with all relational and tabular data sources. It also allows IBM Cognos to 
generate the most optimized SQL possible, for example by removing unused elements 
at query time. 
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Business Analytics fe=” 

SQL Type: Native SQL 

■ Allows SQL that is specific to your database 

■ May not be portable 

■ Cannot contain metadata from multiple data sources 
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When viewing generated Cognos SQL at run-time for a query subject that is set to 
Native SQL, the native SQL appears as a sub-query contained between {}. 



13-8 ©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 



WORK WITH DIFFERENT QUERY SUBJECT TYPES 



Business Analytics 

SQL Type: Pass-Through SQL 

■ Use Pass-Through SQL when a database vendor does 
not extend support for a particular construct in a sub- 
query. 

■ IBM Cognos will pass anything you type directly to the 
database. 
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Pass-Through SQL lets you use native SQL without any of the restrictions the data 
source imposes on sub-queries. 

With Cognos SQL and native SQL, when SQL is generated, IBM Cognos may create 
wrappers for certain queries that go around a sub-query constmct and pass the entire 
constmct (wrapper and sub-query) to the database. Some vendors may not support 
this. Pass-Through SQL will tell IBM Cognos to send only the sub-query to the 
database and then process the remaining SQL constmct (wrapper) locally. 

When viewing Cognos SQL for a query subject that is set to Pass-Through SQL, the 
native SQL that you typed will appear as a sub-query contained between { {} }. 
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Business Analytics 

IBM Cog nos Query Generation 
Architecture 

■ The IBM Cognos user interfaces submit SQL. 

■ The SQL option you have chosen will determine how 
IBM Cognos generates SQL. 



ui 

(Framework 
Manager/ 
IBM Cognos BI 
Studios) 



t 



IBM Cognos Query 




Generation 


. I 


(Cognos SQL, 1 


> 


Native SQL,) | 





1 








(Pass-Through SQL) 
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Purpose: 

As a metadata modeler, you should distinguish between SQL used 
to create and define data source query subjects and SQL generated 
by query subjects. 

Not only will you explore this SQL, you have been asked to provide 
a query item that returns the current year for use in various reports. 
To accomplish this, you will use select construct and vendor 
specific function that requires you to change the SQL Type setting. 

Component: Framework Manager 

Project: GO Operational 

Task 1 . View data source query subject SQL. 

1. In Framework Manager, close any projects that may be open, and then open 
the GO Operational project located at C:\Edcognos\B5152\ 

CBIFM-Start Files\Module 13\GO Operational. 

2. If prompted, log in as User ID admin, and Password Educationl!. 

3. In the Project Viewer pane, expand GO Operational Model>Foundation 
Objects View>gosales. 

4. Double-click SALES_TARGET. 

On the SQL tab, notice the simple, all-inclusive select statement shown below: 
Select * from [GOSALES] .SALES_TARGET 

This statement is written in Cognos SQL, defines the scope of the query subject 
and generates run-time SQL when authoring a report or testing query 
subjects/items in Framework Manager. 
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5. Click the Test tab, and then in the bottom right comer, click Test Sample. 
The data is retrieved and displayed in the Test results pane. 

6. Click the Query Information tab. 

This tab shows the SQL that was generated and used to retrieve the data that 
you saw in the Test results pane. The SQL is presented in both Cognos SQL 
and Native SQL as follows: 

-\ 

J 



Cognos SQL 



select 



f roiifi 



Projection 

list 



S A LE S_T ARGE T . SALE S_YE AR as S A LE S_YE AR , 

S A LE S_T ARGE T . SALE S_PERI OD as SALE S_PERI OD , 

S A LE S_T ARGE T . G OONTRY _C ODE_RE TAI LER as C OONTRY_CODE_RE TAI LER , 

S A LE S TARGE T . S A LE S_S T AE F_CODE as SALE S_S T AE F_C ODE P 

S A LE S_TARGE T . RE TAI LER_C ODE as RE TAI LER_C ODE P 
S A LE S_TARGE T . RE TAI LER_NAME as RE TAI LERHAME , 

S A LE S_TARGE T . PRODUCT TYPE C ODE a s PRODUCT_T YPE_C ODE , 

S A LE S_T ARGE T . PRGDUCT_BRAND_C ODE a s PRODUC T_BRAND_C ODE , 

S A LE S_T ARGE T . S A LE S_T ARGE T as S A LE S_T ARGE T 

GOSAL3S . . GOSALES „ SALES TARGET SALES TARGET 



Native SQL 



select "SALES TARGET 



SALES YEAR 



SALES YEAR 1 



S A LE S_T ARGE T 
S A LE S_T ARGE T 
S A LE S_T ARGE T 
S A LE S_T ARGE T 
S A LE S_T ARGE T 
S A LE S_T ARGE T 
S A LE S_T ARGE T 
SALES TARGET 



1 S A LE S_PERI OD ! 1 1 1 S A LE S_PERI OD 1 1 , 

1 COUNTRY_C ODE_RE TAI LER" " COUNTRY_CODE_RE TAI LER 1 
1 S A LE S_S T AE F_G ODE 1 1 1 1 S A LE S_S T AE F_C ODE ! 1 f 
'RE TAI LER_CODE 11 " RE T AI LERCODE " r 
RE TAI LER_NAME " 1 1 RE TAI LER_NAME 1 1 , 

1 PRODUC T_TYPE_CODE " " PRODUC T_TYPE_C ODE " , 

1 PRODUC T_BRAND_CODE " ' 1 PRODUC T_BRAHD_C ODE ' 1 , 
'SALES TARGET" "SALES TARGET" from 



GOSALES 



SALES TARGET 



SALES TARGET" FOR FETCH ONLY 



13-12 ©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 



WORK WITH DIFFERENT QUERY SUBJECT TYPES 



The syntax in the From clause of the Cognos SQL is composed of the 
following parts: 



GOSATES .. gosales.SAT ES_TARGET SAT ES_TARGET 



1 1 
Content Schema 
Manager 
datasource 



1 

Database 

table 



1 

IBM Cognos alias 



The Cognos SQL is presented as an easy-to-read and formatted version of the 
native SQL. Viewing the native SQL gives a representation of what is actually 
sent to the database. The SQL in both versions select all columns individually 
rather than Select * from RETURNED_ITEM. This is because the SQL is 
generated based on the individual query items that make up the query subject. 
When you test the entire query subject, all query items are included in the query 
and therefore you see each column in the generated SQL. 

Regardless of the type of SQL written on the SQL tab, Cognos SQL will always 
be displayed on the Query Information tab or be available in Report Studio for 
relational data sources. 

7. Click Cancel. 

8. Under SALES_TARGET, right-click the SALES_TARGET query item, click 
Test, and then click Test Sample. 
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9. Click the Query Information tab. 

The results appear as follows: 




Because you only selected one query item to test, only one column appears in 
the generated SQL. All unused items in the scope of the query subject have 
been dropped during optimization. 

10. Click Close. 

Task 2. Use a vendor specific function and configure the SQL 

Type setting. 

1 . In the Project Viewer, right-click the gosales namespace, point to Create, and 
then click Query Subject. 

2. In the Name box, type Current Year, select Data Source (Tables and 
Columns), and then click OK. 

3. Under Select a data source, ensure GOSALES is selected, clear the Run 
database query subject wizard check box, and then click Finish. 

4. Edit the SQL statement to appear as follows: 

Select YEAR(current timestamp) ’’Current Year” FROM 
sysibm.sysdummyl 
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5. Click the Test tab. 

An error message appears indicating there is a syntax error near "Year". Cognos 
SQL does not recognize this particular select statement. Cognos expects a From 
clause and a table name in the SQL statement. You will use the native SQL 
setting to leverage this statement. 

6. Click OK, and then click Options in the lower right corner. 

7. Click the SQL Settings tab, from the SQL Type list, select Native, click OK 
to the message, and then click OK 

8. Click Test Sample. 

The current year based on the server date appears in the results pane. 

You have successfully retrieved the current year using a vendor- specific 
function. You used native SQL due to the nature of your query. You did not 
select any columns from any of the tables in the database and again, Cognos 
SQL requires that you include "from" syntax and a table name to create a valid 
query subject. Native SQL lets you use bypass this rule. You simply asked the 
database to retrieve the current date and then modify it. 



© 2003, 2010, IBM Corporation 13-15 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 




IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 

9. Click the Query Information tab. 

The results appear as follows: 

Cognos SQL 

select 

Cnrrent_Year . "Current Year" as Cnrrent_Year 

from 

(GCSALES. . . Cur ren t_Y ear 

Native SQL 

select n Cur rent_Year ". "Current Year" "Cnrrent_Year" from (Select YEAH ( current timestamp) "Current Year" 
from sysibm. sys dummy 1) "Cnrrenf_Year" F OH FETCH ONLY 

The native SQL is reflected in the derived table portion of the Cognos SQL 
between the {} brackets. Derived tables will be discussed in further detail in 
another module. 

10. Click OK, and then save the project. 

Results: 

By exploring the SQL tab and query information tab of a data source 
query subject, you saw the difference between the SQL that defines 
the scope of the query subject and the SQL that is generated at run 
time. 

You also used a construct not permitted by Cognos SQL and 
changed the SQL Type setting to leverage the construct using a 
vendor specific function. 
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Business Analytics 

Benefits of Using Model Query 
Subjects 

■ Use model query subjects to: 

1. control query paths 

2. behave as views and control query generation 

3. simplify the model for presentation 

4. override settings specified for underlying query 
subjects 

5. resolve recursive relationships 

Cognos 

software 

©2010 IBM Corporation 



1. You can control query paths by using model query subjects as aliases to prevent 
ambiguous joins. 

2. You can control SQL generation with model query subjects by selecting query 
items from more than one underlying query subject and placing relationships on 
the model query subject. This creates As View behavior and will ensure 
underlying joins are honored in all query scenarios. This was seen earlier in the 
course when ORDER_HEADER and ORDERDET ATL S were merged 
together with relationships attached. 
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Once you implement relationships on a model query subject, you must 
implement all required relationships required for queries with that model query 
subject. You can not implement one relationship and also depend on underlying 
relationships to other query subjects to be used. 

You can also control how a model query subject is viewed by the query engine 
(fact or dimension) based on the cardinalities you attach to it. 

3. You can use model query subjects as a container for query items for a simplified 
business view. For example, you can combine product line, product type and 
product info into a simplified and more intuitive product dimension. 

4. Model query subjects simply take a copy of the characteristics of the underlying 
objects on which they are based when they are created. They are independent of 
the underlying objects and can have their default behaviors changed without 
affecting the underlying objects. Changes to underlying objects will also not be 
reflected in the model query subjects. 

5. You can also use model query subjects to resolve recursive relationships by 
creating an alias of a query subject and then relate it back to itself. 
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Using model query subjects, you can override underlying relationships to meet alternate 
reporting requirments. For example, in some reporting instances, authors would like to 
report only on employees who have sales targets. The data source query subjects' 
relationship meet this requirment because they have an inner join. But for other authors 
who would like to report on all employees regardless of whether they have sales targets 
or not, they can use the model query subjects to accomplish this since the cardinality 
has been changes to optional on the Sales Target Fact side. 

Again, once you begin attaching relationships to model query subjects, you will need to 
create all required relationships for the query subject to meet your reporting needs. For 
example, if Sales Target Fact in the slide example will be queried with Time, then a 
relationship to Time would need to be created. The IBM Cognos query engine would 
not go back down to the data source query subject level to try and use the original 
relationship between SALES_TARGET_FACT and TIME_DIMENSION . 

You can also use shortcuts to override underlying relationships. 
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Business Analytics 

Identify Recursive Relationships in 
Framework Manager 

■ Framework Manager displays self-joins in the 
diagram, but does not execute them as queries. 



< — Recursive Relationship 

Between 

SALES_STAFF_CODE 

and 

jTi MANAGER_CODE 
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l..n 

SALES_STAFF 

SALES_STAFF_CODE 
FIRST_NAME 
LAST NAME 



MANAGER CODE 



You must specify the self-join relationship at the data source level for the recursive 
relationship to be displayed in Framework Manager. 

While you can view the metadata that defines the relationship, you cannot edit a 
recursive relationship in Framework Manager. 
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Business Analytics 

Resolve Recursive Relationships 



■ Use model query subjects (or shortcuts) to create and 
modify recursive relationships. 




Can now be edited 
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To modify a relationship that exists as a self- join in the data source, you can create a 
model query subject or shortcut and define a relationship between it and the original 
query subject. 

Using the two query subjects in the slide example, you can create a master-detail query 
based on the same table in the data source. 
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Demo 2: Resolve a Recursive Relationship 



Purpose: 

Currently the GO Operational project uses the MANAGER query item 
from the EMPLOYEE_HISTORY query subject to report on an 
employee's manager. Authors would like to show the managers' 
contact information and report on managers and their employees. 

To accomplish this, you will create an alias of the EMPLOYEE data 
source query subject and relate it to the EMPLOYEE_HISTORY data 
source query subject on MANAGER_CODE instead of EMPLOYEE 
code. This will allow you to use the EMPLOYEE table to retrieve 
manager names and their contact information. 



Components: Framework Manager, Business Insight Advanced 

Project: GO Operational 

Package: GO Operational (query) 

Task 1 . Create an alias to resolve a recursive relationship in 

the data. 

1 . In Framework Manager, in the Project Viewer, under GO Operational 
Model> Foundation Objects View>gosales, create a model query subject 
called Manager. 
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2. Add the following query items: 



Query Subject 


Query Item 


EMPLOYEE 


EMPLOYEE_CODE 

FIRST_NAME 

LAST_NAME 

WORKPHONE 

EXTENSION 

FAX 

EMAIL 


POSmON_LOOKUP 


POSITION_EN 



3. Click the ellipsis beside POSITION_EN and then change the expression 
definition as shown below to implement a language macro: 

#’ [gosales] . [POSITION_LOOKUP] . [POSITIONS 
+$Language_lookup{$mnLocale} + ’]’ # 
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4. Click OK twice, and then create a relationship from Manager (1..1, 
EMPLOYEE_CODE) to EMPLOYEE_HISTORY (l..n, 
MANAGER_CODE) . 

The results appear as follows: 



M anaqer < -> E M PLOYE E HISTD R Y 



Query subject: 
Manager 



EMPLOYEE CODE 



FIRST_NAME 
LAST_NAME 
WORK PHONE 
FAX 
EMAIL 

POSITION EN 




New Link 



Cart jinality 

~ ” 



Operator 






Query subject: 

[E M PLO YEE_H I S TCl R Y 



EMPLOYEES I ST 0RY_C0DE 
E M PLOYE E_H I S T 0 RY_PAR ENT 
EM PLOYE E_C0DE 
R E CO FI D_S TAR T_D AT E 
R E CO R D_E N D_DAT E 
P0SITI0N_C0DE 
POSITION START DATE 



MANAGER CODE 



MANAGER 
MANAGE R_MB 
BRANCH_CODE 

nRRANI7iTinN miTF 
Cardinality 



1..n 






5. Click OK, click No to the message, and then move the Manager model query 
subject below EMPLOYEE_HI STORY to group the items together. 
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6. Right click EMPLOYEE_HISTORY and launch the Context Explorer, 
click the Show related objects button and then click the Auto Layout button 
to arrange in a star schema (you may need to adjust EMPLOYEE_HISTORY 
to see all query items) . 

The results appear as follows: 




The Manager query subject can now query managers and the staff that report to 
them. It resolves the recursive nature of the data highlighted above. 

Because POSITION_EN was placed in the Manager model query subject, that 
now has a relationship defined, As View behavior will occur. All underlying 
relationships will be honored in any query that uses the Manager query subject. 

7. Close the Context Explorer. 
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8. Rename and organize the query items in Manager as shown below: 



- m Manager 






| Manager First Name 








| Manager Last Name 








| M anager Work Phone 








| Manager Extension 








j Manager Fax 








J Manager Email 






0 Manager Position 


-l-p^ Codes 




Manager Code 



Task 2. Incorporate query items from the Manager model 

query subject into the Consolidation View. 




2 . 

3 . 

4 . 

5 . 



In the Project Viewer, expand Consolidation View> Staff by Location. 

You will manually remap the Manager query item in the Staff by Location query 
subject to items in the new Manager model query subject in the Foundation 
Objects View. You want to display the full manager name so you will 
concatenate the manager's first and last name. 

Double-click the Manager query item, and then delete the existing expression. 

In the Available Components pane, expand Foundation Objects 
View>gosales>Manager. 

Double-click Manager First Name to add it to the Expression Definition 

pane, and then type | | ’ ’ | | (there is a single space between the single quotes 
and no space between the pipes) . 



Double-click Manager Last Name to add 

The results appear as follows: 

[gosales] . [Manager] . [Manager First Name] | 
Last Name] 

Note: You could also use + to concatenate 



it to the end of the expression. 

''II [gosales]. [Manager]. [Manager 
the strings. 
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6. Click Test Sample 




The results appear similar to the following: 




7. Click OK, and then double-click Staff by Location. 

8. In the Available Model Objects pane, expand Foundation Objects 
View>gosales>Manager. 

9. Add the following items to the Query Items and Calculations pane: 



• Manager Work Phone 

• Manager Extension 

• Manager Fax 

• Manager Email 

• Manager Position 
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10. Click OK, and then arrange the query items as shown below: 



- §gg Staff by Location 




Staff Region 




Staff Country 






Staff Address 1 




Staff Address 2 






Staff City 






Staff Prov/State 




Staff Postal Zone 




i 


j Staff Full Name 




1 


First Name 




[ 


Last Name 


[ 


] Work Phone 


l 


Extension 


l 


| Fax 




i 


E-Mail 




1 


Position 




i 


Manager 




1 


Manager Work Phone 




1 


Manager Extension 




1 


Manager Fax 




1 


Manager Email 


l 


Manager Position 


E Q Codes 



1 1 . Save the project. 

Task 3. Test the new Manager query subject in Business 

Insight Advanced. 

1 . Publish the GO Operational (query) package. 

2. Launch IBM Cognos Connection, log on, and select Author business 
reports from the Welcome screen. 

3. Select the GO Operational (query) package for a List report. 
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4. In the Insertable Objects pane, expand Sales (query), and then add the 
following items to the report: 



Query Subject 


Query Item 


Time 


Year 


Staff by Location 


Manager 
Manager Position 
Staff Full Name 
Position 


Sales Fact 


Revenue 



5. Group the report on Year, Manager, and Manager Position. 

The results appear as follows: 




Managers are displayed along with staff that currently report to them and the 
revenue they have generated by year. 
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6. Return to IBM Cognos Connection without saving the report. 

Results: 

Using a model query subject to create an alias for the EMPLOYEE 
data source query subject you were able to resolve a recursive 
relationship found in EMPLOYEE_HISTORY. 
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Business Analytics ===== 

Stored Procedure Query Subjects 

■ Two types: 

■ Data Query: 

■ return result sets based on simple to complex queries 

■ must return a single uniform result set 

■ Data Modification: 

■ modify the database 

■ used in Event Studio only 



■ Both types may expect arguments 



Cognos. 

software 

©2010 IBM Corporation 



For Data Query stored procedure query subjects, Framework Manager can leverage the 
stored procedure by generating a query subject that reflects the returned result set. 

If a stored procedure returns multiple result sets, IBM Cognos only supports the first 
result set. IBM Cognos will define the metadata according to the result set returned by 
the stored procedure when it is first created in Framework Manager. An error is 
generated at mn time if the stored procedure returns a different result set than originally 
defined when the stored procedure query subject was created. 
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Some data source systems allow for multiple stored procedures with the same name, 
but each accepts a different number and/ or type of arguments. The number and type 
of arguments passed determine which stored procedure is used. This is known as an 
overloaded signature. To work with overloaded signatures, create multiple stored 
procedures, each with a unique name, and create a separate query subject for each result 
set or signature. 

Output parameters are not supported. 

Data Modification stored procedure query subjects let you leverage a stored procedure 
from the data source to update data in the data source. These types of stored procedure 
query subjects are only available for use in Event Studio. 
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In general, it is better to define prompts in the reporting application to make use of the 
additional prompt features. However, there are some variables that report authors 
cannot modify such as parameters in a stored procedure. For these, you can use 
Framework Manager to define prompts. 

Prompt values can also be used in: 

• parameter maps 

• session parameters 

• expressions including filters, calculations, and relationships 
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Demo 3: Create and Test a Data Query Stored Procedure 

Query Subject 



Purpose: 

Management has requested a quick reference tool for the IBM 
Cognos reporting environment to allow phone representatives at 
the call center to quickly retrieve information for specific orders. A 
stored procedure exists in the GOSALES database that can be 
leveraged to create this tool. 

To accomplish this, you will create a stored procedure query 
subject and configure it appropriately. 



Components: Framework Manager, Business Insight Advanced 

Project: GO Operational 

Package: GO Call Center 

Task 1 . Create a stored procedure query to retrieve data. 

1 . In the Project Viewer, create a folder called Stored Procedures in the gosales 

namespace. 

2. Right-click the Stored Procedures folder, point to Create, and then click 

Query Subject. 

3. In the Name box, type Find Order Information, select Stored Procedure, 

and then click OK. 

4. In the Select a data source pane, ensure GOSALES is selected, and then click 

Next. 

5. In the Stored Procedures pane, expand GOSALES>GOSALES>Procedures. 
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6. Click the FINDORDERINFO stored procedure, and then click Finish. 

The Query Subject Definition window for the stored procedure appears. 

Note: You can also import a stored procedure using the Metadata Import 
Wizard. If you do, initially the query subject will appear broken. You 
must edit the query subject to verify its projection list. After testing the 
query subject and retrieving the projection list, the query subject appears 
normal in the Project Viewer. 

You will now add a prompt value to allow for user input as opposed to hard 
coding a value for the ORDERNUMBER argument. 

7. Click the ORDERNUMBER argument, and then click the ellipsis in the 
Value column. 

8. In the Value pane, type POrder Number?. 

9. Click OK, and then click the Test tab. 

The Prompt Values dialog box appears. In order to prevent continually being 
prompted, you will clear the Always prompt for values when testing box. 

1 0. Click in the V alue field, type 100002, clear the Always prompt for values 
when testing, and then click OK 

1 1 . Click T est Sample in the bottom right corner. 

The results appear as follows: 



Test Results 




QRDER.NUMBEF 


RETAILERJJAME 


P ROD IJCTjN UMBER 


ORDER.DATE 


SHIF_DATE 


100002 


At fresco 


75110 


Jan 12, 2004 12:00:00 AM 


Jan 13, 2004 12:00:00 AM 
Jan 13, 2004 12:00:00 AM 
Jan 13, 2004 12:00:00 AM 
Jan 13, 2004 12:00:00 AM 
Jan 13, 2004 12:00:00 AM 




100302 


Aj- fresco 


70110 


Jan 12,200412:00:00 AM 




100002 


At fresco 


•35110 


Jan 12, 2004 12:00:00 AM 




100002 


At fresco 


05110 


Jan 12,200412:00:00 AM 




100002 


.Ar fresco 


100110 


Jan 12,2004 12:00:00 AM 



Several records are returned in the Test Results pane with related order 
information. 



12. Click OK, and then save the project. 
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Task 2. Edit query item properties and create a relationship 

PRODUCT_NAME_LOOKUP. 

The stored procedure returns a product number but not a product name, which 
would be more useful for your application. You can create a relationship to the 
PRODU CT_N AME_LOOKUP query subject using PRODU CT_NUMBER to 
later obtain the appropriate product name. 

1 . Under the Stored Procedures folder, expand Find Order Information. 

2. Ctrl+ click ORDER_NUMBER, and PRODU CTJNUMBER, and then, 
in the Properties pane, change the Usage property for both query items to 

Identifier. 

In this case, you know that the underlying fields in the database are in fact 
indexed and can therefore be set as identifiers instead of attributes. 

3. In the Project Viewer under gosales, click 

PRODU CT_NAME_LOOKUP, and then Ctrl+click Find Order 
Information. 

4. Right-click either query subject, and then click Create Relationship. 
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5. Change the relationship to be from PRODUCT_NAME_LOOKUP 1..1 to 
Find Order Information 1..1 on PRODUCT_NUMBER, as shown below: 



Name: 

| PR 0 D U CT_N AM E_LO 0 K.IJ P <-> Find Order Information 



Query subject: Query subject: 

|PR0DUCT_NAME_L00KUP New Link | |Find Order Information \3 



PRODUCT NUMBER 


ORDER NUMBER 


PRODUCT LANGUAGE — 


RETAILER NAME 


PRODUCT NAME ■ 


PRODUCT NUMBER t 


PRODUCT DESCRIPTION 


ORDER DATE 
SHIP DATE 
ORDER CLOSE DATE 
QUANTITY 
ACTUAL REVENUE 



Cardinality 


U per at or 


Cardinality 


|i i $ 


1 = 2 


h -i 3 



PRODUCT_NAME_LOOKUP, in this case, will act as a lookup table for Find 
Order Information to retrieve product name values. 

6. Click OK, and then save the project. 
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Task 3. Create a Find Order Information model query subject. 

Now that you have a relationship between Find Order Information and 
PRODU CT_NAME_LOOKUP, you can create a model query subject that 
retrieves all the required information for your call center application. You will 
create a business view for this application. 

1 . In the Project Viewer, in the Presentation View namespace, create a new 
namespace called Call Center Application. 

The results appear as follows: 



Project Viewer 


- i 


^ GO Operational 

- [||] GO Operational Model 
-]■■ ‘S Presentation View 1 

+ 'S GO Operational Sales {query | 

Call Center Application 

+ 1 - \ L 1 CnnsolidFitinri Vipw 



2. In the Call Center Application namespace, create a new model query subject 
called Find Order Information, and then click OK 

3. In the Available Model Objects pane, expand Foundation Objects View> 
gosales> Stored Procedures>Find Order Information. 

4. Add all query items to the Query Items and Calculations pane except 

PRODU CT_NUMBER. 

5. Expand PRODUCT_NAME_LOOKUP, and then add 
PRODU CT_NAME to the Query Items and Calculations pane. 

6. Arrange PRODU CT_NAME so that it is the third item in the list using the 
green arrows on the right side of the dialog box. 
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7. Click the Test tab, and then click Test Sample in the bottom right comer. 

The order information appears with the appropriate product name, as shown 
below: 



Test results 




0RDER_N UMBEF 


RETAILER_NAME 


PRODUCT_NAME 


ORDER_DATE 


100002 


At fresco 


Mountain Man Deluxe 


Jan 12, 2004 12:00:00 AM 




100002 


.Ar fresco 


Edge Extreme 


Jan 12, 2004 12:00:00 AM 




100002 


At fresco 


Bear Edge 


Jan 12, 2004 12:00:00 AM 




100002 


At fresco 


Glacier GPS Extreme 


Jan 12, 2004 12:00:00 AM 




100002 


Aj- fresco 


Insect Bite Relief 


Jan 12, 2004 12:00:00 AM 



8. Click OK 

9. Expand Find Order Information, and then, if time permits rename the query 
items as shown below: 



- BOH F 


ind Order Information 


M 


Order Number 


IS. 


|] Retailer Name 


i a 


2Q Product Name 


i a 


Ip Order Date 


I a 


Slip Date 


i a 


fp Order Dose Date 




|] Quantity 


! a 


^ Actual Revenue 



If time is short, you can skip renaming all query items as this will be done for 
you at the start of the next module. 
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Task 4. Create a new package for the call center phone 

representatives. 





In the Project Viewer, create a package called GO Call Center that only 
contains Find Order Information from the Call Center Application 

namespace. 



The results appear as follows: 



GO Operational Model 



X ▼ Presentation View 



^ GO Operational Sales (query) 



=H X 



✓ 



^ Call Center .Application 

Find Order information 




|j|- X k Consolidation View 



X - Foundation Objects View 



Click Finish. 



You are prompted to open the Publish Package wizard. 

3. Click Yes. 

4. Clear the Enable model versioning check box, click Next, click Next, click 
Publish, and then click Finish. 

The Verify Model dialog appears listing informational messages. 

5. Click Close, and then save the project. 



Task 5. Test the Find Order Information query subject in 

Business Insight Advanced. 

1 . Launch IBM Cognos Connection, log in, and then launch Business Insight 
Advanced selecting the GO Call Center package for a List report. 

2. Drag the Find Order Information query subject to the report. 

An Order Number prompt appears. 
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3. In the Provide a number box, type 100004, and then click OK 

A list appears displaying all the records for the requested order number, as 
shown below: 



Order 

Number 


Retailer 

Name 


Product Name 


Order Date 


Ship Cate 


Order Close date 


Quantity 


Actual 

Revenue 


100004 


Ac ar livre 


Hitematcr Lite 


Jan 12, 2004 


Jan 21,2004 


Jan 21. 2004 


U fm. 


29,653.12 








12:00:00 AM 


12:00:00 AM 


12:00:00 AM 






100004 


Ao ar livre 


Star Gazer 2 


Jan 12,2004 


Jan 21, 2004 


Jan 21.2004 


139 


75,239.35 








12:00:00 AM 


12:00:00 AM 


12:00:00 AM 






100004 


Ao ar livre 


Star Lite 


Jan 12. 2004 


Jan 21. 2004 


Jan 21,2004 


261 


35.341.42 








12:00:00 AM 


12:00:00 AM 


12:00:00 AM 






100004 


Ao ar livre 


TrailChef Deluxe 


Jan 12, 2004 


Jan 21. 2004 


Jan 21.2004 


275 


33,653.56 






Cock Set 


12:00:00 AM 


12:00:00 AM 


12:00:00 AM 






Overall - 


Summary 










1,033 


22S.447.45 



4. Return to IBM Cognos Connection, do not save changes, and leave 
Framework Manager open for the next demo. 

Results: 

By incorporating a stored procedure query subject with a prompt 
value into the model you were able to provide an easy-to-use call 
center application. 
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Demo 4: Create and Test a Data Modification Stored 

Procedure Query Subject 



Purpose: 

A request has come in to make a stored procedure available from 
the GOSALES database for use in Event Studio. This stored 
procedure updates columns in the RETURNEDJTEM table. Authors 
would like to automate a process to notify sales representatives 
when an order has a return. The automated process will then assign 
the sales representative responsible for the order by updating the 
RETURNEDJTEM table. The sales representative is then expected 
to follow up with the customer. 

To accomplish this, you will create a stored procedure query subject 
and configure it appropriately. 

Component: IBM DB2 Control Center, Framework Manager 

Project: GO Operational 

Stored procedures can update databases such as adding, updating, or deleting records. 

Business users can use Event Studio to author agents that monitor changes in your data 
based on defined conditions. When conditions are met, the agent can mn a series of 
tasks, including an update database task. This task is defined by leveraging a stored 
procedure that you can include in a model and publish as part of a package. 

There are typically limited scenarios in which this technique is used. Most organizations 
do not allow external applications to update source data. In any application that does 
use a stored procedure to update data, the database administrator has control over 
supplying a procedure that limits the update to specified columns and tables in the data 
source. 

IBM Cognos places restrictions on the use of stored procedures that update data in a 
data source. They can only be leveraged from within an Event Studio agent. They 
cannot be accessed in any other studio. 
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Task 1. Examine the AssignStaff stored procedure in IBM DB2. 

1. From the Start menu, point to All Programs>IBM DB2> 

DB2COPY1 (Default) > General Administration Tools and then click 
Control Center. 

2. Select the Advanced radio button and click OK. 

3. Expand All Databases>GS_DB>Application Objects, and then click 
Stored Procedures. 

4. Scroll to the ASSIGNSTAFF stored procedure visible in the right pane. 
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5. Right-click the ASSIGNSTAFF stored procedure, and then click Show SQL 
Procedure Body. 

The Show SQL dialog box appears as shown below: 




This stored procedure updates the RETURNED_ITEM table. It adds the sales 
staff code to the ASSIGNED_TO column, and retrieves and adds the system 
date to the DATE_AD VISED column. It also has two arguments that must be 
supplied: SALES_STAFF_CODE and ORDER_DETAIL_CODE. 

6. Click Close, and then close Control Center. 
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Task 2. Test the RETURN EDJTEM query subject. 

1 . In Framework Manager, in the Project Viewer, if necessary, expand the 
Original Sales & Returns Objects folder. 

2. Test the RETURNED_ITEM query subject. 

3. Scroll to the right until you see the ASSIGNED_TO column. 

The results appear as follows: 





Test results 






0 FI DEFL DETAIL. CODE 


RET IJ Fl N R EAS 0 N CO D E 


RETURN. QUANTITY 


ASSIGNED _T0 


FOLLOWUP CODE 






4000059 


1 


30 




-1 






G000325 


4 


152 




-1 






5000097 


1 


14G 




-1 






8021 4477 


4 


47 




-1 



Notice that the ASSIGNED_TO values are null. You will import a stored 
procedure to update columns in this table and test for the 
ORDER_DETAIL_CODE value of 4000059, the first row in this table. 

4. Click Close. 

Task 3. Import the stored procedure into the model. 

1 . Right-click the Stored Procedures folder, point to Create, and then click 

Query Subject. 

2. In the Name box, type AssignStaff, select Stored Procedure, and then click 

OK 

3. In the Select a data source pane, ensure GOSALES is selected, and then click 

Next. 

4. In the Stored Procedures pane, expand GOSALES>GOSALES>Procedures. 
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5. Click the ASSIGNSTAFF stored procedure, and then click Finish. 

The Query Subject Definition window for the stored procedure appears. 

You will now add prompt values to allow for user input as opposed to hard 
coding values for the expected arguments. 

6. Click the PARAM_SALES_STAFF_CODE argument, and then click the 
ellipsis in the Value column. 

7. In the Value pane, type PSalesStaffCode?. 

8. Click OK, and then add the following prompt value for the 

PARAM_ORDER_DETAIL_CODE argument: 

POrderDetailCode? 



The results appear as follows: 



Argument Name 


Mode 


Type 


Format 


Value 


PAR AM_0 R D E R_D E TAI L_C0 D E 


in characterLengthl 6 S ize=34. Precision^ 6.. S cal ?□ rderD etailCode? 


FAR AM_S ALE S_S TAFF_C0 D E 


in 


int32 


Size=4, Precision^, Scale= 


?SalesStaffCode? | 



9. Click the Test tab. 

The Prompt Values dialog box appears. 

10. Click in the Value field for OrderDetailCode, type 4000059, click the Value 
field for SalesStaffCode twice, type 572, and then click OK. 

An error message appears stating the stored procedure is unable to return a 
result set. This is because the stored procedure updates a table and does not 
retrieve rows from a table. You will modify the definition of this stored 
procedure query subject to act as a data modification stored procedure query 
subject. 

1 1 . Click OK, click Cancel, and then click the Definition tab. 

In the Type box, notice that the current setting is Data Query. With this setting, 
the stored procedure, when tested, should return a result set. 
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12. Change the Type setting to Data Modification. 

13. Click the Test tab, and then click Test Sample. 

14. Click OK. 

A message appears stating the stored procedure executed successfully. 

15. Click OK three times, and then save the project. 

Task 4 Re-test the RETURNEDJTEM query subject. 

1 . In the Original Sales & Returns Objects folder, test the 
RETURNEDJTEM query subject. 

2. Scroll to the right until you see the ASSIGNED_TO column. 



The results appear as follows: 



Test results 




ORDER J3ETAI L_C0 D E 


R ET U R N_R EASO N_C0 D E 


R ETU R N_Q U ANTITY 


ASSIGNED JO 


FDLLDW_UP_COD 




4000059 


1 


30 


572 


-1 




saati325 


4 


152 




-1 




r nnnn ^7 


J 







A 



Notice that the ASSIGNED_TO value in the first row is now 572, the value 
you provided in the prompt dialog. If you scroll right a little further, you will see 
that the DATE_AD VISED column has a value for the current date and time. 
The row for ORDER_DETAIL_CODE 4000059 was successfully updated. 

3. Click Close, and leave Framework Manager open for the next demo. 

This stored procedure can now be added to a package and used in Event 
Studio. 

Results: 

By creating a stored procedure query subject and configuring it 
appropriately, you successfully created and tested a query subject 
that can be leveraged in Event Studio to update the GOSALES 
database. 
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Business Analytics 

Modify Relationships 

■ You can modify the: 

■ link(s) 

■ cardinality 

■ operator 

■ expression 



Cognos, 

software 

©2010 IBM Corporation 



Name: 






DUCT TYPE PRODUCT <-> SALES TARGET 



Query subject; 



Product Type 4 Product 



S] 



Query subject: 



New Irk 



SALES TARGET 



s] 



PRODUCT TYPE CODE 



PRODUCT 

PRODUCT' 

PRODUCT' 

PRODUCT 

PRODUCT 

PRODUCT' 

ppnm itt 



UNE CODE 
TYPE EN 
TYPE'FR 
TYPE.DE 
TYPE NL 
TYPE'JA 

TYPC~cr 



P RO D UCT.TYP E.KO 
PRODUCT TYPE CS 
PRODUCT TYPE HU 
PROnilTT TYPP PT 



Retationstxp tnpact: 




SALES.YEAR 
SALES PERIOD 
COUNTRY CODE RETAILER 
SALES.STAFF.CODE 
RETAILER.CODE 
RETAILER NAME 



PRODUCT TYPE CODE 



ppnnMf-T_RPSNn rnnc 
SALES TARGET 



Cardinality 




Operator 




Cardnality 


1' i _d 




I- 




|l./i _^j 



Each SALES.TARGET has one and only one Product Type 4 Product. 
Each Product Type 4 Product has one or more SALES.TARGET. 



Expression: 



_! 



Product Type 4 Product.PRODUCT_TYPE.CODE » SALES_TARGET.PRODUCT_TYPE.CODE 



You can choose which key or keys link two query subjects together, control their 
cardinality, and specify different operators. 



You can also create complex join conditions in the Expression editor. For example, you 
may want to extend the join syntax to include other filter criteria. This way the filter is 
applied only if items from both query subjects are used, and leaves the individual query 
subjects unrestricted in other query scenarios. 



Modifying any of the relationship settings is reflected in the generated SQL. For 
example, optional cardinality on one end will generate a left outer join in the generated 
SQL, and optional cardinality on both ends will generate a full outer join in the 
generated SQL. 
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Demo 5: Create a Compound Relationship Expression 



Purpose: 

Currently there is a filter on the EMPLOYEE_HISTORY data source 
query subject. This filter limits the records to each employee's 
current record. Because a filter has been applied to this query 
subject, its record set is restricted in all query scenarios. Human 
Resources have requested the ability to report on employee history. 

To accomplish this, you will move the filter from the 
EMPLOYEE_HISTORY data source query subject to the relationship 
expression between EMPLOYEE_HISTORY and EMPLOYEE. You will 
then create a model query subject as an alias to EMPLOYEE with a 
relationship to EMPLOYEE_HISTORY so that human resources staff 
can author their reports. 



Component: Framework Manager 

Project: GO Operational 

Task 1. View the existing EMPLOYEE_HISTORY filter and 

move it to a relationship expression. 

1. In the Project Viewer, double-click EMPLOYEE_HI STORY, and then 
click the Filters tab. 
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2. In the Source column beside the Current Employee History Record filter, 
click the ellipsis. 

The results appear as follows: 



Name: 


r e=i i 


3b^=n 


Current Employee History Record 







Expression definition: 

|[gosales] .[EM P UD YEE_H1ST0 RY] [R ECO R D_EN D_D ATE] IS NULL 

This is a filter applied on a data source query subject to retrieve only the most 
recent record per employee (the one with no End Date assigned). 

3. Copy the expression in the Expression definition pane, and then click Cancel. 

4. Delete the filter, and then click OK. 

You will now test the effect of removing the filter. 

5. Select and test the following items: 



Query Subject 


Query Item 


EMPLOYEE 


EMPLOYEE_CODE 

FIRST_NAME 

LAST_NAME 


EMPLOYEE_HISTORY 


EMPLOYEE_HISTORY_CODE 

MANAGER 



Some employees have more than one record. These are their current and 
historical records. This is the type of reporting human resources staff would like 
to do. 
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6. Click Close, right-click EMPLOYEE_HISTORY, click Launch Context 
Explorer, and then click Show Related Objects. 

7. Double-click the relationship between EMPLOYEE_HISTORY and 
EMPLOYEE. 

8. Click the ellipsis beside the Expression pane, at the end of the expression, 
type and, and then paste the syntax from the filter after the word and. 

9. Click OK 

The results appear as follows: 



Name: 

(EMPLOYEE <--> E M PL0YEE_HIST0RY 



Query subject: 

[employee - 



EMPLOYEE CODE 



FIFiST_NAME 

FIRST_NAME_ME! 

LAST_NAME 

LAST_NAME_MB 

DATE_HIRED 

TERMINATION_DATE 

TERMINATION_CODE 

BIRTH_DATE 

GENDER_CODE 

W0RK_PH0NE 

F'x'T F M £ I fl M 



R elationship impact: E ach E M PLU YE E_H I S 0 R Y has one and only one E M PLUYE E . 

Each EMPLOYEE has one and only one E M PLOYE E_HI STORY. 



Expression: 




EMPLOYEE. EMPLOYEE CODE = EMPLOYEE HIS TORY. EMPLOYEE CODE and 
E M PLOYE E_H 1 S T 0 R Y. R E CO R D_E N D_D AT E IS NULL 




□ 





zl 

Cardinality 

rrtfl 



New Link 



perator 

F 3 



Query subject: 



EMPLOYEE HISTORY 




E M PLOYE E_H I S T 0 R Y_C0 D E 
EMPLOYEE HISTORY PARENT 



EMPLOYEE CODE 



R E CO R D_S TAR T_D AT E 

RECORD_END_DATE 

POSITIONJIODE 

PO S I T 1 0 N_S TAR T_D AT E 

MANAGE R_C0DE 

MANAGER 

MANAGE R_MB 

BRANCH_CODE 

qrGlMJJZAJIDN rnnF 



zl 



Cardinality 



The link between the two query subjects is no longer present since the 
expression contains non-join specific syntax. 
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10. Click the Relationship SQL tab, and then scroll down until you see the where 
clause. 



The results appear as follows: 



Sample SQL statement, using the relationship: 



from 



where 



i i >ii ii i ■ ■ i ii_i i um ■! a .i— mi l-Lj 1 ii u l_ as iljitii i_l_=* ■ LL_ujyL i , 

E M P LO YEE_HIST0 R Y. R ECO R D_START_D ATE as R ECO R D_START_D ATE , 

E M P LO YEE_HIISTO R Y. R ECO R D_END_D ATE as R ECO R D_EN D_D ATE , 

E M P LO YEE_H1ST0 R Y.POSITIO N_COD E as POS ITIO N_CO D E. 

E M P LO YEE_HIISTO R Y.POSITIO N_START_D ATE as POS ITIO N_START_D ATE 
E M P LO YEE_HISTO R Y. MAN AG ER_CO D E as MAN AG ER_CO D E , 

E M P LO YEE_H ISTO R Y. MAN AG ER as MANAGER. 

E M P LO YEE_H!STO R Y. MAN AG ER_M B as MANAGER_MB, 

E M P LO YEE_HISTO R Y.B R ANC H_CO D E as BRANCH_CODE, 

EMPLOYEE H ISTO REORGANIZATION CODE as ORGANIZATION CODE 



GOS ALES .GOS ALES .gosaleshr. EM P LO' YEE EM P LO YEE, 

GOS ALES .GOS ALES .gosaleshr. EM P LO YEE_H ISTO R Y EM P LJO YEE_H ISTO R Y 



{{E M P U0 YEE. EM P LO YEE_COD E = EM P LO YEE_HISTO R Y. EM P LO YEE_COD E) 
and (E M P LO YEE J-1ISTO R Y. R ECO R D_EN D_D ATE is NULL )) 



Your compound expression is reflected in the generated SQL. 
1 1 . Click the Test button. 



Multiple records per employee no longer exist. Records for the employee codes 
10016 and 10020 only appear once. This filter will only be implemented when 
items from both query subjects are used in a query or the relationship between 
them is used in a query path. For example, if your query contained an item from 
EMPLOYEE_HISTORY and S AT ES_T ARGET_F ACT, EMPLOYEE will 
be in the query path and therefore the filter will be applied. 

12. Click OK, and then close the Context Explorer. 
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Task 2. Create an alias for EMPLOYEE using a model query 

subject. 

Human resources staff will use this new alias to report on historical employee 
data without the restriction of the filter that you removed from the 
EMPLO YEE_HIST ORY data source query subject. 

1 . In the Project Viewer, right-click EMPLOYEE, and then click Merge in 
New Query Subject. 

2. Click No to creating the underlying relationships. 

3. Rename the new EMPLO YEE_EMPLOYEE model query subject to 

Employee (Human Resources) (alias). 

4. Create a relationship between Employee (Human Resources) (alias) (1..1) 
and EMPLOYEE_HISTORY (l..n) on EMPLO YEE_CODE . 

5. Click OK, and then click No when asked to create other underlying 
relationships. 
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6. Select and test the following items: 



Query Subject 


Query Item 


Employee (Human Resources) 
(alias) 


EMPLOYEE_CODE 

FIRSTJNAME 

LAST_NAME 


EMPLOYEE_HISTORY 


EMPLOYEE_HISTORY_CODE 

MANAGER 



The results appear as follows: 



e§t results 


EMPLOYE ENCODE 


FIRST_NAME 


LAST_NAME 


EMPLOYEE_HISTORY_CODE 


MANAGER 


1 03S9 


Aaltje 


Hansen 


30336 


Ulla Blackmore 


1 0004 


Denis 


Page 


30000 


Dietz Krieger 


1 0005 


Elizabeth 


M ichel 


30001 


Frederic Samson 


1 0006 
1 0007 


Emile 


Clermont 


30002 


Frederic Samson 


Etienne 


J auvin 


30003 


Frederic Samson 


1 001 2 


Elsbeth 


Wiesinger 


30004 


Else Mbrike 


1 001 3 


Else 


Mbrike 


30005 


Barbara Samuelsen 












1 001 4 


Frank 


Fuhlroth 


30006 


Georges Saint-Germain 


mniF 


Hunter 




-mnriT 


FEhplh V.'.v'ip-rj^jjnpr 


1 001 6 


Bjorn 


Winkler 


30956 


Gretchen Goetschy 


1 001 6 


Bjorn 


Winkler 


30008 


Fritz Hirsch 


1 001 7 


Fritz 


Hirsch 


30009 


Else Mbrike 


1 001 8 


Jbrg 


Kurfze 


3001 0 


Denis Page 


1 001 9 


Silvano 


AJIessori 


3001 1 


Maria lacobucci 


1 0020 


Maria 


lacobucci 


30938 


Derek Hirsch 


1 0020 


Maria 


lacobucci 


3001 2 


Fabian Tibor 


1 0021 


Alessandra 


T orta 


3001 3 


Maria lacobucci 


1 0022 


Belinda 


Jansen-Velasquez 


3001 4 


Kick Kalkman 


1 0023 


Ellen 


Shapiro 


3001 5 


Kick Kalkman 



The historical records are now returned when querying between the employee 
alias query subject and EMPLOYEE_HISTORY and can be leveraged by the 
human resources staff. 
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7. Click Close, and then save and close the project. 

8. If necessary, close any open browser windows and then close Framework 
Manager. 

Results: 

By moving a filter out of the EMPLOYEE_HISTORY data source 
query subject and into the relationship expression between 
EMPLOYEE_HISTORY and EMPLOYEE, you extended the model's 
reporting capabilities where employees are concerned. You created 
an alias for EMPLOYEE with a model query subject, and changed its 
relationship configuration to EMPLOYEE_HISTORY so that human 
resources staff can report on all employee data. 
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Business Analytics =^==^?§: 

Considerations When Modifying Query 
Subjects 

■ When modifying any query subject or relationship, 
view the generated SQL to verify your intended 
modeling technique. 

■ Modifying data source query subjects may make them 
"complex" and cause IBM Cognos to request 
metadata from the database. 

■ When you add relationships to model query subjects, 
encapsulated joins are honored. 



Cognos* 

software 

©2010 IBM Corporation 
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Business Analytics 



Summary 

■ You should now be able to: 

■ identify key differences and make 
recommendations for using data source, model, 
and stored procedure query subjects 

■ identify the effects on generated SQL when 
modifying query subjects, SQL settings and 
relationships 



Cognos, 

software 

©2010 IBM Corporation 
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Set Security in Framework 

Manager 



IBM Cognos BI 




Business Analytics 

©2010 IBM Corporation 






IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



14-2 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 




SET SECURITY IN FRAMEWORK MANAGER 



Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ examine the IBM Cognos security environment 

■ restrict access to packages 

■ create and apply security filters 

■ restrict access to objects in the model 

v M 



Cognos, 

software 
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Business Analytics 



Framework Manager Workflow 




©2010 IBM Corporation 



This module deals with applying security to your model in Framework Manager based 
on security requirements defined for your IBM Cognos environment. 
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Business Analytics 



Examine IBM Cognos Security 

■ Consists of: 

■ third-party authentication providers 

■ used to authenticate users and secure objects 

■ Cognos namespace 

■ used to create IBM Cognos specific groups and roles to 
secure objects 

■ capabilities and user interface profiles 

■ used to grant or deny users access to IBM Cognos 
components or features 

■ Security is optional - anonymous access is allowed 

Cognos. 

software 

©2010 IBM Corporation 



IBM Cognos can leverage one or more third-party authentication providers to 
authenticate users. You can use the providers to define and maintain users, groups, and 
roles as required. 

In addition IBM Cognos provides its own namespace called Cognos. The Cognos 
namespace contains groups and roles that, by default, define user privileges in the IBM 
Cognos environment. You can use this namespace to enhance your organization's 
security policies and ensure the portability of your applications. For example, you can 
exclusively use Cognos namespace groups and roles to secure your application and 
simply add users or groups from a third-party authentication provider. If you port your 
application to a different environment, you can continue to use the Cognos groups and 
roles and add the appropriate users or groups from the new authentication provider. 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



14-5 



I B M 



COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Business Analytics 

Set Security in Framework Manager 

■ When you apply security in Framework Manager, you 
control access for selected users, groups, and roles. 

■ Grant or deny access for: 

■ packages 

■ data 

■ objects 



Cognos, 

software 

©2010 IBM Corporation 



Package access refers to the ability to use the package in an IBM Cognos studio (for 
example, Query Studio), or to mn a report that uses the package from IBM Cognos 
Connection. Users without these abilities are denied access, although they can still view 
saved report outputs if they have access to the reports. You can also give 
administrative access to packages for users who are required to republish packages or 
perform impact analysis based on model changes. 

Data security restricts the data returned by query subjects. You create a security filter 
that is placed on a specific query subject and applied to specific users, groups, or roles, 
that will be using that query subject. 

When you add object security, you are restricting access to objects, such as query 
subjects, query items, and filters. 
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Business Analytics 

Permissions 

■ When you specify permissions for objects, you allow 
or deny the following permissions: 

■ Read 

■ Write 

■ Execute 

■ Set Policy 

■ T raverse 

Cognos. 

software 

©2010 IBM Corporation 



Read: View all the properties of an entry. 

Write: Modify properties of an entry. Delete an entry. Create entries in a 

container, such as a package or a folder. Modify the report specification for 
reports created in Report Studio and Query Studio. Create new outputs for 
a report. 

Execute: Process an entry such as running a report or retrieving data through data 

source connections. 

Set Policy: Read and modify the security settings for an entry. 

Traverse: View the contents of a container entry, such as a package or a folder, and 

view general properties of the container itself without full access to the 
content. 
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Demo 1 : Specify Package Access 



Purpose: 

You want to ensure that only Query Users and Authors can access 
the GO Operational (query) package and that only System 
Administrators can administer the package. 

You will view the results in IBM Cognos Connection by logging in as 
a systadmem administrator and then as a query user and author. 



Components: Framework Manager, IBM Cognos Connection 

Project: GO Operational 

Package: GO Operational (query) 

Task 1 . Provide administrator privileges to the GO Operational 

(query) package for system administrators. 

Because you can only specify security in the Publish wizard on the first publish 
of a package, this first step will remove the package from the Content Store 
which will reset the publish history. Alternately, you can just configure admin 
access for a package in the package properties. 

1 . Launch IBM Cognos Connection, log in, and then delete the GO 

Operational (query) package. 

2. In Framework Manager, open GO Operational.cpf located in 
C:\Edcognos\B5152\CBIFM-Start Files\Module 14\GO Operational. 
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3. If prompted, log in as User ID admin, and Password Educationl!. 

4. In the Project Viewer pane, expand Packages, right-click GO Operational 
(query), click Publish Packages, and then click Next. 

The Add Security page is a quick and easy method of adding initial security to a 
package. As stated on the page, these settings are only available on the initial 
publish. After being published, you must modify permissions using the 
Permissions dialog box that will be demonstrated later in this demo. 

On the Add Security page, note that there are two tabs. You have the 
opportunity to grant either user access or administration access to specific 
security users, groups, or roles. 

• The User tab grants Read, Write, Execute, and Traverse permissions. 

• The Administrator tab grants Read, Write, Set Policy, and Traverse 
permissions. Set Policy gives the ability to modify security permissions. 

You will specify security for both users and administrators. You will allow user 
access to the package for the Query Users role and administrator access to the 
System Administrators role to see the effects in IBM Cognos. 
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5. Click Add. 

The results appear as follows: 




Note: This UI is the same as in IBM Cognos Connection. Framework Manager 
is simply accessing it. 

There are two sources to identify security users, groups, and roles. 

• 'Cognos' is the container for groups and roles defined within IBM Cognos. 

• ' LD AP' is the container for users and groups defined within the Sun Java 
System Server Console. 
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kk 

6. Click Cognos, click Next Page I I, select Query Users, and then 



7. 



click Add 






The results appear as follows: 



Available entries 
Directory > Gog nos 

Show users in the list 



Selected entries 
Entries: \l~ 



|7 



H M ►► ► 



Entries: flG - | 



- 25 



H 


44 




►1 





I” | | Name 

r aa "lanning Contributor Users 
r 33 Planning Rights Administrators 
r 33 Portal Administrators 
r 33 PowerPlay Administrators 
r 33 D owerPlay Users 
r 33 Query Users 



r 




_> Name 


r 


33 


— > Query Users 



Remove 



You can also select groups or individual users from the authentication provider 
(in this case Local LDAP) namespace to meet any security requirements you 
may have. 

Click OK, click the Administrator Access tab, and then click Add. 







8. Click Cognos, and then click Next Page 



9. Select System Administrators, and then click Add 

10. Click OK, click Next, and then deselect the Verify the package before 
pubHshing check box. 

1 1 . Click Publish, and then click Finish. 

Task 2. Test the Package Security. 



1 . In IBM Cognos Connection, click Refresh I La I , and then beside GO 




Operational (query), click Set Properties lii= 
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2. Click the Permissions tab. 

The results appear as follows: 



[■71 Override the access permissions acquired from the parent entry 



□ 


1 


— >Nane 


Permissions 


□ 




— >Query Users 


t?o ^b '■% 


Jo 


□ 


33 


— >System Administrators 


L. o 


& Jo 








Add.,. 


Remove 



3. View the pop-up tips over each of the Permissions icons. 

You are looking at the permissions for all the defined users, groups and roles (in 
this case there are only roles defined) . 

• Query Users have Read, Write, Execute, and Traverse permissions 

• System Administrators have Read, Write, Set Policy, and Traverse 
permissions 

You can grant or deny different permissions to individual users, groups, and 
roles in this UI through IBM Cognos Connection or Framework Manager. You 
can also add or delete users, groups, and roles. 

Note that in the first check box, Override the access permissions acquired from 
the parent entry, is selected. This is because you explicitly added roles, which 
Overrides the default setting of the parent container, Public Folders. 

4. Click Cancel, and then, on the title bar beside Admin Person, click Log Off. 

You will now log on as a Query User member to see the effects of package 
access security. 

5. Log on as whites (Sally White) (password = Education!!). 
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7. 

8 . 
9. 



Click IBM Cognos content, and then, beside GO Operational (query), click 



Set Properties 




Sally White is only a member of the Query U sers role and not the System 
Administrators role. Notice that there is no Permissions tab. You were able to 
see the package in Public Folders (and you can access it in the Studios), but you 
cannot view or edit its permissions without the Set Policy permission. 



You will now log on as a user from the Authors role. 

Click Cancel, and then, on the title bar beside Sally White, click Log Off. 



Log on as brettonf (Frank Bretton) (password — Educationl!) . 



Click IBM Cognos content. 



Notice the GO Operational (query) package is not visible. This is because Frank 
Bretton is only a member of the Authors role that does not have user access 
defined for this package. 

You will give the Authors role user access permissions and then limit the access. 



Task 3. Edit the package security in Framework Manager. 



1 . In Framework Manager, ensure the GO Operational (query) package is 
selected, and then from the Actions menu, point to Package, and then click 

Edit Package Settings. 

2. Click the Permissions tab. 

Again, this is the same page you saw in IBM Cognos Connection. You can use 
either one, as they both access the same settings in the portal. You have access 
to the Permissions tab because you are still logged on as admin within 
Framework Manager. 

3. Click the Add link to add the Authors role from the Cognos namespace. 
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4. Select the Authors check box, and then specify permissions as shown below: 



| — >Na me 0 Permissions 




I - Grant Deny 


p 33 ... > Authors II \ Jo 

r 33 - >Query Users V Q Jg 

S3 - >Sy stem Administrators gg % i5 . Jg 




\~^\ Read 0 0 

\ Write □ 0 

( Execute 0 0 

8 Set Policy 0 0 

j_ Traverse 


Add... Remove 



Notice that Read, Write, and Execute permissions have been explicitly denied, 
Set Policy has been implicidy denied, and Traverse has been granted. 

Click OK, and then publish the GO Operational (query) package. 

In IBM Cognos Connection, still logged on as Frank Bretton, click Refresh. 

The GO Operational (query) package now appears. 

From the Launch menu, click Business Insight Advanced. 

Notice that the GO Operational (query) package is no longer a link. 

Click Cancel, and then click GO Operational (query). 

While in the GO Operational (query), from the Launch menu, click 

Business Insight Advanced. 

Click Create New, and then double-click List. 

The results appear as follows: 

IBM Cognos Business Insight Advanced (*) 

QE-DEF-0157 

The model or package /content'package[iOiname= l GO Operational 
(query)']/model[!0:name= 'model'] does not exist or you are not allowed to use it 
because of security settings. 

Details: 

DPR -ERR -2082 An error has occurred. Please contact your administrator. The complete 
error has been logged by CAF with 5ecureErc'rID:2O10-lT23-22:35:44,829-#2 

Frank Bretton cannot author reports with this package because he has been 
denied the permission. 
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1 1 . Click OK, and then close Business Insight Advance. 

12. In Framework Manager, from the Actions menu, point to Package, and 
then click Edit Package Settings. 

13. Click the Permissions tab, select the Authors check box, and then select the 
Grant check box for the Read, Write, and Execute permissions. 

1 4. Click OK, and then publish the package again. 

1 5. In IBM Cognos Connection, still logged on as Frank Bretton, launch 
Business Insight Advanced selecting the GO Operational (query) package. 

1 6. Click Create new, and then double-click List (you may need to log off and 
then log on again to clear the session cache and see the effects of the security 
change) . 

Business Insight Advanced opens and Frank Bretton has access to the contents 
of the package. 

17. Close the browser, and then in Framework Manager, save the project. 

Results: 

You limited administrative control of the GO Operational package to 
members of the System Administrators role. You also allowed 
access to the package for members of the Query Users and Authors 
role. You tested various settings to see the effects in IBM Cognos 
Connection and in Query Studio. 
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Business Analytics 

Specify Data Security 

■ To specify data security: 

1. create a security filter to restrict the data 
returned by a query subject 

(for example, Retailer. Region ='Italy') 

2. add the groups and roles to which the 
security filter will be applied (for example, the 
Italy group) 

■ This affects: 

■ authors when they create a report 

■ users when they run a report 

Cognos. 

software 

©2010 IBM Corporation 



A security filter controls the data that is shown to report authors when they test their 
reports, and when users run reports. The filter expression can incorporate macros, 
parameter maps, and session parameters. 
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Demo 2: Specify Data Security 



Purpose: 

Sales managers at The Great Outdoors Company want to ensure 
that Camping Equipment sales representatives only see orders 
relating to the Camping Equipment product line. 

To accomplish this, you first need to create and add members to the 
Sales Managers and Camping Equipment Reps groups. You will 
grant these groups access to the GO Operational (query) package. 

You will then apply a security filter to the Products query subject to 
restrict their access to camping equipment data. Finally, you will 
publish the package and view the results in Business Insight 
Advanced. 



Components: Framework Manager, Business Insight Advanced 

Project: GO Operational 

Package: GO Operational (query) 

Task 1 . Create the Sales Managers and Camping Equipment 

Reps groups. 

1. Launch IBM Cognos Connection, log on as admin (password = 
Educationl!) . 

2. Under Administration, click Administer IBM Cognos content, and then 
click the Security tab. 

3. Click Cognos, and then click New Group 

4. In the Name box, type Camping Equipment Reps, and then click Next. 

5. Click Add, click LDAP, and then click Search in the top right corner. 
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6 . 

7. 



Click Advanced, and then in the Type list, click Users. 

In the Find text in box, type kunze, and then click Search. 
The results appear as follows: 



Available entries 

Directory > LDAP 

Find text in: Name field ▼ 



I kunze 

Method: Contains the exact 




Advanced *i 
/\ 



Type: Users ▼ 

Scope; "his folder and ts subfolders 



Results: 



Entries: 1 



- 1 



o 



H 


M 




►I 



> INane 



|" Q — > Jorg Kunze (kunzej) 



8. Under Results, select the Jorg Kunze check box, click Add 
then click OK 

9. Click Finish. 




and 



10. Click New Group, and then repeat steps 3 to 9 to create the Sales Managers 
group and add Kazumi Uragome (uragomek) as a member. 

1 1 . Beside Authors, click Set Properties, and then click the Members tab. 

12. Click Add, click Cognos, and then click Next Page. 

13. Select Sales Managers, click Add, and then click OK twice. 



14-18 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 



SET SECURITY IN FRAMEWORK MANAGER 



Task 2. Grant access to the GO Operational (query) package. 



1 . In Framework Manager, ensure the GO Operational (query) package is 
selected. 

2. From the Actions menu, point to Package, and then click Edit Package 
Settings. 

3. Click the Permissions tab. 

4. Click Add, click Cognos and then select Camping Equipment Reps and 
Sales Managers groups you just created. 

5. Click Add, and then click OK 

6. Select the Camping Equipment Reps and Sales Managers check boxes. 

7. Under Grant in the right box, select the Read, Write, Execute, and Traverse 
check boxes. 



The results appear as follows: 



F Override the access permissions acquired from the parent entry 



r 


j 


— Name A 


Permissions 






r 


aa 


— >Authors 


tiS 


V- 

© 






J© 


F 


9a 


— >Camping Equipment Reps 




% 


c+ 6 




-J© 


r 


3a 


... >Query Users 


kilo 


% 


c+ b 






F 


9a 


... >Sales Managers 


ms 




■© 




-S 


r 


3a 


... >System Administrators 


ms 


V. 




& 


J© 



Add.., Remove 



1 




Grant 


r Deny 


II 


Read 


0 


□ 


\ 


Write 


0 


□ 




Execute 


0 


□ 


a 


Set Policy 


□ 


□ 


A 


Traverse 


0 


□ 



8. Click OK 
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Task 3. Create a security filter for the Product query subject. 

1. In the Project Viewer pane, expand GO Operational Model> Consolidation 
View. 

2. Click Products, and then from the Actions menu, click Specify Data 
Security. 

3. Click Add Groups. 

4. Click Cognos, select the Camping Equipment Reps check box, and then 
click Add. 

5. Click OK 

At this point, if you already had another group defined with a filter on camping 
equipment products, you could click below Based On and specify that other 
group. In this situation you do not, so you will create a new filter. 

6. Click the box in the first row under the Filter column, and then click 

Create/Edit Embedded. 

7. In the Available Components pane, expand GO Operational Model> 
Consolidation View>Products>Codes. 

8. Double-click Product Line Code, at the end of the expression, 
type — 991 . 

The results appear as follows: 



Expression definition: 


•:<— 

— 

•> — 




jt % e \* 


[Consolidation View], [Products! [Product Line Code] =991 



This filter will ensure that members of the Camping Equipment Reps will only 
see camping equipment products. 

9. Click OK twice, and then save the project. 
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Task 4. Publish the package and view the results in Business 

Insight Advanced. 

1 . Publish the GO Operational (query) package. 

2. In IBM Cognos Connection, log off, and then log on again with as 
uragomek (password = Educationl!) . 

Uragomek is a member of the Sales Managers group. 

3. Launch Business Insight Advanced selecting the GO Operational (query) 

package to create a List report. 

4. In the Insert Data menu, expand Sales (query) >Products, and then double- 
click Product Line and Product Type. 

The results appear similar to the following: 



Product line 


Product type 


Pers o n a 1 Access o ries 


Binoculars 


Mountaineering Equipment 


C limiting .Accessories 


Camping Equipment 


Cooking Gear 


Pers o n a 1 .Access o ries 


Eyewear 


Outdoor Protection 


First Aid 


Golf Equipment 


Golf Accessories 


Outdoor Protection 


Insect Repellents 


Golf Equipment 


Irons 


Pers o n a 1 Access o ries 


Knives 


Camping Equipment 


Lanterns 


Pers o n a 1 Access o ries 


Navigation 


Camping Equipment 


Packs 


Golf Equipment 


Putters 


Mountaineering Equipment 


Rope 



Notice that Kazumi Uragome can see product data for all product lines. He is a 
member of the Sales Managers group and the security filter applied in Task 2 
does not apply to this group. 
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On the toolbar, click Save — [ l in the Name box, type Demo 2 - Security 
Filter Test, and then click Save. 



6. Close IBM Cognos Business Insight Advanced, log off, and then log on again 
as kunzej (password = Education!!). 

Jorg Kunze is a member of the Camping Equipment Reps group. 

7. Click IBM Cognos content, click the GO Operational (query) folder, and 
then click Demo 2 - Security Filter Test. 

The result appears as shown below: 



Product Line 


Product Type 


Camping Equipment 


Cooking Gear 


Camping Equipment 


Lanterns 


Camping Equipment 


Packs 


Camping Equipment 


Sleeping Bags 


Camping Equipment 


Tents 



Due to the data security placed on the Product query subject for the Camping 
Equipment Reps group (of which Jorg Kunze is a member), only product 
quantities from the Camping Equipment product line are shown in the report. 
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8. Close the browser. 

Note: If a user does not belong to any of the groups specified in security filters, 
then they will have unrestricted access to the data, regardless of the 
restrictions specified by the filter expressions. In some cases, you may 
want to avoid this scenario and completely restrict access to particular 
groups or roles. 

To completely restrict access, you can create a filter expression that will 
always resolve to a false outcome. For example, you can create a filter 
expression that reads [Consolidation View] . [Products] . [Product Line 
Code] = 1 where 1 does not exist in the data for Product Line Code. 

This expression will always resolve to false. You could then specify the 
groups or roles to which this filter expression will be applied. The result 
is that a user who is a member of the defined groups or roles for this 
filter expression will be completely denied access to the data (provided 
they are not members of a group that does have access to the data). 

Results: 

You created and added members to the Sales Managers and 
Camping Equipment Reps groups. You granted these groups 
access to the GO Operational (query) package. You then applied a 
security filter to the Products query subject to restrict access to 
product line data. Finally, you published the package and viewed the 
results in Business Insight Advanced. 
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Business Analytics 


= = === 


Specify Object Security 




■ Allow or deny access to objects such as: 




■ namespaces 




■ folders 




■ query subjects 




■ query items 




■ filters 






Connos 

software 
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When granting access to objects, ensure that the selected users, groups, or roles have 
access to the package that contains them. 

An example of applying object security is to only allow access to the Sales Targets 
namespace to the Sales Managers group. Then only members of the Sales Manager 
group will see the Sales Target namespace in the studios. 
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Business Analytics 

Examine Object Security Rules 

■ With no object security applied, all objects are 
accessible. 

■ After applying object security, only those objects to 
which access has been granted will be accessible by 
the selected users, groups, or roles. 

■ Child objects inherit the security of parent objects. 

■ Deny overrides Allow. 



Cognos, 

software 
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When you begin to apply object security (Allow or Deny), all other objects, other than 
the children of the object you specified security on, are automatically not visible to any 
user (including members of the System Administrator role) until access is explicitly 
granted. Only those objects to which access has been explicitly granted for the selected 
users, groups, or roles, are visible. 

When you set object security on a parent object, a child object inherits the security of 
the parent if object security has not already been specified for the child object. 

In the case of an access conflict (for example, being a member of two groups with 
conflicting access to an object), denied access to the object overrides granted access to 
it. 
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Business Analytics 

Specify Object Security: 
Methodologies 

■ There are two approaches when beginning to 
implement object-based security in a model: 

■ Allow access to all objects, and then restrict 

■ Restrict an object, and then allow access as 
required 



Cognos, 

software 
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Allow access to all objects, and then restrict: 

1. Make all objects accessible to everyone (open the root namespace's access 
control list, and then select the Allow check box for the Everyone group) . 

2. Restrict access to specific child objects for selected users, groups, or roles by 
either explicidy denying access (Deny option) or implicitly denying access by 
leaving both Allow and Deny options unselected. Deny overrides allow which 
ensures that a user does not accidentally gain access to an object through 
another group or role that has access. 

Restrict an object, and then allow access as required: 

1. Apply initial security to an object to allow specific users, groups or roles access 
to the object (this automatically implements security across the model and 
makes all other objects inaccessible to all users). 

2. Grant access to specific objects for selected users, groups, or roles as required. 
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Demo 3: Specify Object Security 



Components: IBM Cognos Connection, Framework Manager, Business 

Insight Advanced 

Project: GO Operational 

Package: GO Operational (query) 

Purpose: 

You want members of the Sales Managers group to access all 
metadata under the GO Operational Sales (query) namespace. This 
includes access to the Sales Target namespace, which will allow 
them to run reports that include the projected sales targets for each 
sales rep. 

At the same time, you want to restrict the access to the Sales 
Targets (query) namespace so that members of the Sales Reps 
group cannot access projected sales targets for each sales rep. 

You will begin by creating and adding members to a new group 
called Sales Reps. 

You will grant access to the GO Operational (query) package to the 
new Sales Reps group, and grant or deny access to the appropriate 
objects for the Sales Managers and Sales Reps groups. 

Lastly, you will publish the GO Operational (query) package and 
view the results in Business Insight Advanced. 
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Task 1 . Create a new Sales Reps group and add a member. 

1 . Launch IBM Cognos Connection, log on as admin (password = 
Educationl!). 

2. Under Administration, click Administer IBM Cognos content, and then 
click the Security tab. 

3. In the Cognos namespace, create a new group called Sales Reps, and then add 

Bart Scott and Daniel Turpin from LDAP. 

Task 2. Grant access to the GO Operational (query) package. 

1 . In Framework Manager, in the Project Viewer pane, select the GO 
Operational (query) package, and then from the Actions menu, point to 
Package, and then click Edit Package Settings. 

2. Click the Permissions tab, click Add, and then click Cognos. 

3. Click Next Page, select the Sales Reps check box, and then click Add. 

4. Click OK, select the Sales Reps check box, and then under Grant, select the 
Read, Write, Execute, and Traverse check boxes. 

The results appear as follows: 



F Override tine access permissions acquired from frie parent entry 
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->Name 


Permissions 
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... >Authors 
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... >Camping Equipment Reps 
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Deny 
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5. Click OK 
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Task 3. Specify object security on the GO Operational Sales 

(query) namespace for the Sales Managers and Sales 
Reps groups. 

1 . In Project Viewer, under Presentation View, click the GO Operational 
Sales (query) namespace. 

2. From the Actions menu, click Specify Object Security, and then click Add. 

3. Click Cognos, click Next Page, and then select the Sales Managers and 
Sales Reps check boxes. 

4. Click Add, and then click OK. 

5. Under Allow, select the Sales Managers and Sales Reps check boxes, and 
then click OK 

A message appears indicating that for an object to be visible in IBM Cognos, it 
must be made visible to the user within the package and by allowing the user 
access to the object. 

6. Click OK 

The security you just specified on the GO Operational Sales (query) namespace 
will be inherited by all its children. 

You will now restrict access to the Sales Targets (query) namespace. 
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Task 4. Specify object security on the Sales Targets (query) 

namespace for the Sales Reps group. 

1 . Expand the GO Operational Sales (query) namespace, click the Sales 

T argets (query) namespace, and then from the Actions menu, click Specify 
Object Security. 

The Specify Object Security box appears. Notice that the Sales target 
namespace has inherited the security that was applied to its parent object, the 
GO Operational Sales (query) namespace. 

2. Beside Sales Reps, select the Deny check box, and then click OK. 

A message appears, indicating that the security for the Sales Targets (query) 
namespace will override the settings already specified for the GO Operational 
Sales (query) namespace. Rather than select deny, you could also just have 
deselected the Allow setting for Sales Reps, which would have implicitly denied 
access, but the method you have implemented ensures members of this group 
will not have access regardless of any other group they belong to. 

3. Click OK, and then save the project. 

Task 5. View the results in Business Insight Advanced. 

1 . Publish the GO Operational (query) package. 

2. In IBM Cognos Connection, log off, and then log on again as uragomek 
(password = Education!!) . 
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3. Under My Actions, click Author business reports, and then click GO 
Operational (query). 

This user, being a member of the Sales Managers group, has access to all 
namespaces in the package, including the Sales Targets (query) namespace. This 
is due to the security that you specified. 

4. Click Create new, and then double-click List. 

5. In the right pane, expand all of the namespaces. 

Notice that they are empty. There are no query subjects available. 

You will investigate this issue shortly in Framework Manager. 

6. Close IBM Cognos Business Insight Advanced. 

7. Click Log off, and then log on as turpind (Daniel Turpin) (password = 

Educationl!) . 

8. Click Query my data, and then click GO Operational (query). 

The results appear as follows: 





Menu 




Insert Data 




Edit Data 
Chanae Layout 
Run Report 
Manaae File 




±j 

+ 


GO Operational (query) 
H Sales (query) 
s' Returns (query) 



This user, being a member of the Sales Reps group, does not have access to the 
Sales target (query) namespace. This is due to the object security that you 
specified. This group has been explicitly denied access to this object. 

9. Expand any of the namespaces. 

Again, no objects are available. 

10. Close the browser. 
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6. Grant access to objects pointed to by shortcuts. 

In Framework Manager, in the Project Viewer, expand GO Operational 
Sales (query) > Sales (query). 

When you granted access to the GO Operational Sales (query) namespace, the 
security is inherited at all levels below it, which is why you see the namespaces. 
But the namespaces do not contain any query subjects, only shortcuts to query 
subjects located elsewhere in the project. In this case they are located in the 
Consolidation View. Security on shortcuts is not inherited by the underlying 
objects. Even though users have access to the shortcuts, they still need access to 
the underlying objects in order to see them. 

You will grant access to everyone for all other objects in the model that have 
not already been configured with object security. This way you can ensure that 
users will have access to underlying objects and then restrict as required. 

Click the GO Operational Model namespace (the root namespace), and then 
from the Actions menu, click Specify Object Security. 

The results appear as follows: 





Allow 


Deny 


9 

jjti Everyone [Directory > Cognos] 
i* Sales Managers [Directory > Cognos] 


r 


r 


r 


r 


St* Sales Reps [Directory > Cognos] 


r 


r 



Notice that no one is allowed access. This applies to all other objects you have 
not yet configured object security for. By allowing access to everyone, all objects 
will inherit this setting with the exception of the objects you already configured. 

3. Under Allow, select the Everyone check box, and then click OK. 

You may also choose to use another group to open up access to users such as 
the All Authenticated Users group, or any other group that meets your 
requirements. Using the Everyone group is just used for the purposes of this 
demo and not a requirement for this method to work. 
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4. Save the project, and then publish the GO Operational (query) package. 

5. Launch IBM Cognos Connection, log on as turpind (password = 
Education!!). 

6. Launch Business Insight Advanced selecting the GO Operational (query) 

package for a List report. 

Daniel Turpin still cannot see the Sales Targets (query) namespace even though 
he has access to the underlying query subjects. This is because he has been 
denied access to the namespace and the shortcuts it contains. 

Also, notice that the Retailer Location Filters folder is now visible. This is 
also a shortcut in the GO Operational Sales (query) namespace. Now that the 
underlying object is available to everyone, it is visible. 

7. Expand Sales (query) > Sales Fact. 

You now see the query subjects and query items. 

8. Close the browser. 



Results: 

You granted access to the GO Operational (query) package to the 
new Sales Reps group. You granted access to the GO Operational 
Sales (query) namespace for the Sales Managers and Sales Reps 
groups. You then denied access to the Sales Targets (query) 
namespace for the Sales Reps group. 

After publishing the GO Operational (query) package and viewing 
the results in Query Studio, you identified an issue with your 
security implementation. You then opened up security on all 
remaining objects in the project at the root namespace to fix the 
problem. 
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Here is an additional and advanced technique you can use to apply security. 

Use environment session parameters in a macro to create a dynamic data security filter 
when you want the security to only apply to specific groups. 

You could also use the macro in the slide example above directly in the query subject, 
but then the security would be applied to everyone using the query subject rather than 
specific groups or people. For example, you want members of the Sales Managers 
group to have access to all sales targets and not be restricted. Conversely, you want to 
restrict members of the Sales Reps group to only have access to their own data and not 
other sales reps. Data security filters can accomplish this. 
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Demo 4: Implement Security Using a Macro in a Data Security 

Filter 



Components: Framework Manager, Business Insight Advanced 

Project: GO Operational 

Package: GO Operational (query) 

Purpose: 

You have been asked to publish a package in which members of the 
Sales Managers group can view sales targets for all employees, but 
members of the Sales Reps group can only see their own sales 
targets. 

You will create a parameter map, and a macro that references an 
environment session parameter to implement data security for a 
particular group on a query subject. 



Task 1 . Change the security from the last demo. 

Because you are allowing Sales Reps members to have access to their own sales targets 
data, you will need to alter the security you previously implemented and allow Sales 
Reps members access to the Sales Targets (query) namespace. 

1 . In Framework Manager, in the Project Viewer pane, under GO 
Operational Sales (query), click the Sales Targets (query) namespace. 

2. From the Actions menu, click Specify Object Security. 

3. Select Allow for Sales Reps, and then click OK. 
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2. Create a parameter map. 

In the Project Viewer pane, right-click Parameter Maps, point to Create, and 
then click Parameter Map. 

In the Name box, type SecurityLookup, select Base the parameter map on 
existing Query Items, and then click Next. 

Expand Consolidation View> Staff by Location, click Staff Full Name, and 
then click Set as Key. 

Expand the Codes folder, select Sales Staff Code, and then click Set as 

Value. 

Staff Full Name acts as the unique key for the parameter map and Sales Staff 
Code acts as the substitution value that will be used to apply security in a data 
security filter. 

By basing this parameter map on existing query items in the data source, the 
parameter map will always reflect the latest data updates. As new employees join 
the company, they will automatically be reflected in the parameter map. 

Again, to optimize this approach, you can filter the query subject used to feed the 
parameter map to make it more efficient. In this case, first make a copy of the 
query subject, filter it dynamically on Staff Full Name = accountdefaultName, 
and then base the parameter map off new query subject. It will only return one 
record when the parameter map is called and prevents scanning the whole table. 
Since this is a relatively small table and in the interest of time, you will simply use 
the existing query subject. 
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5. Click Next. 



The results appear as follows: 



Default value: 






Key 


Value 


Denis Page 10004 


Elizabeth Michel 


10005 


1 Emile Clermont 


10306 


Etienne Jauvin 


10007 


□sbeth Wiesinger 


10012 


Bse Mbrike 


10013 


Frank Fuhlroth 


10014 


Gunter Erier 


10015 


Bjorn Winkler 


10010 


Fritz Himch 


10017 


Jbrg Kunze 


10013 


Silvano Allessori 


10013 


Maria lacobucd 


10020 


Alessandra Tort a 


10021 


Belinda Jansen-Velasquez 


10022 


Blen Shapiro 


10023 


Jan Haverkamp 


10024 


Kick Kalkman 


10025 





You can provide a default value in cases where no match is found in the 
parameter map. In these cases, the default value will be used, which will return 
specific data of your choice. In this case however, you do not want to return 
any data if there is no match so you will leave the field blank. 

6. Click Finish. 
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Task 3. Apply data security to a query subject. 

You will now secure the original S AFE S T ARGFT query subject in the Foundation 
Objects View so that the security will be carried forward to all objects that reference it, 
now and in the future. 

1. Under Foundation Objects View>gosales, click SALES_TARGET. 

2. From the Action menu, click Specify Data Security. 

3. Click Add Groups, click Cognos, and then click Next Page. 

4. Add Sales Reps. 

5. Click OK, and then, under the Filter column, select Create/Edit Embedded. 

6. Under Available Components, expand GO Operational Model> 
Foundation Objects View>gosales>SALES_TARGET. 

7. Double-click SALES_STAFF_CODE to add it to the expression definition. 

8. At the end of the expression, type =. 

9. Under Available Components, click the Parameters tab, expand Parameter 
Maps, and then double-click SecurityLookup to add it to the expression. 

1 0. In the Expression definition, place the cursor between {} of the 

#$SecurityLookup{}# expression. 

11. Under Available Components, collapse SecurityLookup, expand Session 
Parameters, and then double-click account.defaultName to add it to the 

expression. 

The Expression definition indicates that there is an error with the expression 
represented by a red squiggly underline. The pane below describes the error. 
This is due to the fact that you are currendy logged in as admin. This account 
name does not exist in the data and therefore can not resolve the filter. 

You will now override the accountdefaultName value in order to test and 
validate this filter. 
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1 2. Click Options *=* I, under Session parameter, click Set, and then in the 

Override Value field for account.defaultName, type Daniel Turpin. 

13. Click OK, and then click OK again. 

The results appear as follows: 



Expression definition: 






*■ 

!&■■ 






■3 I£j| | Irt 



(gosales][SAl_ES_TARGET][SALES_STAFF_CODE] = ^Security Lookup 
{^account .default Name}# 











Igosales] [S ALES_TARG ET] [5 ALES_STAFF_CO DE] =1 


|l0fl77| 





Notice that the red line is gone and that the expression now resolves to a value. 

1 4. Click OK, and then click OK again. 

15. Save the project. 



Task 4. Publish and Test the package in Business Insight 

Advanced. 

1 . Publish the GO Operational (query) package. 

2. Open IBM Cognos Connection, log on as turpind (password = 
Educationl!). 

Remember, Daniel Turpin is a member of the Sales Reps group. 

3. Launch Business Insight Advanced selecting the GO Operational (query) 

package. 
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4. Click Create new, and then double-click List. 

5. In the Insertable Objects pane, expand Sales Targets (query) > Staff by 
Location. 

6. Add Staff Full Name to the report. 

All names are returned since the filter is on the sales target data. 

7. Expand Sales Target Fact, and then add Sales Target to the report. 

The results appear as follows: 



Staff Full Name 


Sales Target 


Daniel Turpin 


30.S0S.000 


Overall - Summary 


30,303,000 



The report is now limited to sales target for Daniel Turpin. 

8. Save the report as Demo 4 - Security Filter Test. 

9. Log off, and then log on as scottb (password=Educationl!). 

Bart Scott is also a member of the Sales Reps group. 

10. Click IBM Cognos content, click GO Operational (query), and then click 
Demo 4 - Security Filter Test. 

The results appear as follows: 



Staff Full Name 


Sales Target 


□art Scott 


3S.2 00.000 


Overall - Summary 


33,209,900 



Data is now limited to this user. 

You will now log on as a member of the Sales Managers group to test their 
access. 

11. Log off, and then log on as uragomek (password=Educationl!). 
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12. Run the Demo 4 - Security Filter Test report. 
The results appear as follows: 



Staff Full Name 


Sales Target 


Aaltje Hansen 22,113,800 


Abram Ruiz 


44,933,900 


Adda Heijman 


2.1,362,300 


Adriaantje Haanraads 


24,463,300 


Agatha Reyes 


21,327,200 


Agnelo Chavez 


15,469,300 


Agnes Ramos 


25,934,300 


Aidan Chaplin 


10,973,300 


Aiko Watanabe 


39,354,200 


Aila Forssell 


13,515,400 


Aimi Tanaka 


14,553,010 


Akpmi Takahaqha 44 5 FB. TOO 



The report returns all employees and their sales targets. 
13. Close the browser. 



Results: 

You published a package in which members of the Sales Managers 
group can view sales targets for all employees, but members of the 
Sales Reps group can only see their own sales targets. 

You created a parameter map, and a macro that references an 
environment session parameter to implement data security for the 
Sales Reps group on the SALES_TARGET query subject. 
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Demo 5: Remove Security 



Purpose: 

In order to remove the impact of security applied in this module on 
future modules, you will remove the security applied throughout this 
module. This is a good exercise as it will show you how to undo 
various security implementations. 



Components: Framework Manager 

Project: GO Operational 

Package: GO Operational (query) 

Task 1 . Remove security from the package. 

1 . Select the GO Operational (query) package, and then go to 

Actions >Package>Edit Package Settings. 

2. Click the Permissions tab, and then clear the Override the access 
permissions acquired from the parent entry check box. 

A window opens explaining that this will cause the parent's policies to be 
acquired. 
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3. Click OK 

The results appear as follows: 



' Override the access permissions acquired from the parent entry 



r | J 


— >liame A 


PermE5&k>n& 


33 


... >Analysis Users 


S 




C+ ® 




^® 


33 


... ^Authors 


_ -5> 


V 






J® 


33 


... >Consumers 


_-5> 




ft. 

-a 




^9 


33 


... >Controller Administrators 


Slo 


v. 

> o 


c+ ® 


& 


J® 


33 


... >Control er Users 


ET® 




c+ ® 




J® 


33 


... >Data Manager Authors 


_© 




c+ ® 




-i® 


33 


... >Express Authors 


S?Oi 


V- 






^9 


33 


... >Metrics Administrators 


L® 


V 




LO 


^9 


33 


... >Mefrics Authors 


Sfo 










33 


... >Metrics Users 


_ ® 










33 


... >Planning Contributor Users 


E® 




c+ ® 




J® 


33 


... ^Planning Rights Administrators 


_© 


V- 


ft. 


% 


.a® 


33 


... >PowerPlay Administrators 


E® 


V 


ft ■ 

■® 


LO 


^9 


33 


... >PowerPlay Users 


Slo 








-J® 


33 


... >Query Users 


E® 








-a® 


33 


... -- Readers 


-S- 








-J® 


33 


... >Report Administrators 




% 


^o 


L© 


^9 



This package is now available to all the roles that have access to the other 
packages found in the Public Folders area of IBM Cognos Connection. 

4. Click OK 
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Task 2. Remove Data Security. 

1 . In the Project Viewer, under Consolidation View, select Products. 

2. From the Actions menu, click Specify Data Security. 

3. Delete the Camping Equipment Reps group, and then click OK. 

4. Repeat steps 1 to 3 to delete the group from SALES_TARGET in the gosales 
namespace. 



Task 3. Remove object security. 

1 . In the middle pane, click Explorer. 

2. In the Project Viewer, double-click the Packages folder to give it focus in the 

Explorer. 

The results appear as follows: 




Notice the security based packages. These packages contain the security 
information you specified earlier. 
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3. Double-click _Sales Managers to view the definition. 
The results appear as follows: 



4. 



Package Definition - _Sales Managers [Director 



□■■I 



pjjfl GO Operational Model 



□■■Hi 




Presentation View 



j $ |V 


m 


GO Operational Sales (query) 


j Eli 1 




Call Center Application 


s SB'S 


Consolidation View 



1 1 P 1 1 1 ! I 



EE rf§ Foundation Objects View 



Here you can see the objects this group has access to. 
Click Cancel. 



You will now remove all object security by deleting the _Everyone package. 

5. Select the _Everyone package and then press delete. 

A message appear stating that this role is required for security implementation 
and that removing it will remove all object security from the model. If you just 
wanted to remove the Sales Managers group security, you could just delete that 
one object. 

6. Click OK, and then save and close the project. 

Results: 

You removed the user access and admin access restrictions you 
applied earlier by inheriting the GO Operational (query) parent's 
permissions setting. 

You removed data security filters that you applied and you also 
removed all object security by deleting the _Everyone role security 
package which removed all object security from the project. 
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Business Analytics 

Summary 

■ You should now be able to: 

■ navigate the IBM Cognos security environment 

■ restrict access to packages 

■ create and apply security filters 

■ restrict access to objects in the model 

% m 



Cognos, 

software 

©2010 IBM Corporation 
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IBM Cognos BI 




Business Analytics 
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Business Analytics ^ 

Objectives 

■ At the end of this module, you should be able to: 

■ apply dimensional information to relational 
metadata to enable OLAP-style queries 

■ sort members for presentation and predictability 



Cognos. 

software 

© 201 0 IBM Corporation 
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Business Analytics 



Framework Manager Workflow 



Framework Manager 



Create 

Project 




Import 

Metadata 



Prepare 

Metadata 



Model 

Metadata for 
Reporting 




Publish 




Set 

Security 




Create and 
Manage 
Packages 




Data 

Sources 







Report Studio 
Query Studio 
Analysis Studio 
■ ■ ■ ■ 


Content 
Store 





Cognos, 

software 
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This module deals with creating analysis objects that allow authors to perform OLAP- 
style queries. 
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Business Analytics 

Define Dimensionally Modeled 
Relational (DMR) Metadata 

■ In IBM Cognos, DMR refers to the dimensional 
information a modeler supplies for a relational data 
source to allow for OLAP-style queries. 

■ This information is defined through: 

■ Regular Dimensions 

■ Measure Dimensions 

■ Scope Relationships 

Cognos. 

software 

©2010 IBM Corporation 



A dimensionally modeled layer can be applied to any metadata in star schema format. 

When your metadata is in star schema format, you can provide hierarchy information 
to dimensions and measure scope. 

DMR allows for OLAP-style queries that include d rill up and down functionality and 
access to dimensional functions such as parent( [member]) or except(<L£ve/>,set([member1 ] , 
[ member! ], [member! ])). 

Again, data access strategies should be considered before embarking on any modeling 
solution. OLAP cubes or a relational star schema database that employs aggregate 
tables can yield better performance than providing dimensional information for an 
operational system. 
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Providing dimensional information in your Framework Manager models allows 
IBM Cognos to create multi-dimensional structures, such as the one above, at mn time. 
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Business Analytics 



What Do Authors See? 



Dimension 



Level — 
Member • 

Child 

members 



=1 Product 

a .".Product < Hierarchy 

l±l Cl Members 
+] [“] Product(All) 



® Product line 
bJ & Members 

d ™ Camping Equipment 
±J ns Cooking Gear 
+ n Tents 
+ r~j Sleeping Bags 
±! c* Packs 
±] ™ Lanterns 






Mountaineering Equipment 
d n Rope 
±J czj Safety 
+ czsi Climbing Accessories 
±) n Tools 

i£j ob Personal Accessories 




Report Studio 



Data Tree 



Cognos. 

software 
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Just as with OLAP data sources, authors will be presented with multi-dimensional 
metadata in the studios when you apply dimensional information to your model. They 
will also see members in member aware studios (Analysis Studio and Report Studio). 
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Business Analytics =^==^“ 

Package Types and IBM Cognos 
Studios 

■ Business Insight Advanced, Report Studio, Query 
Studio, and Event Studio can access all package types 
(Relational, OLAP, or DMR). 

■ Analysis Studio can only access dimensional packages 
(OLAP or DMR). 



Cognos. 

software 

©2010 IBM Corporation 



Business Insight Advanced, Report Studio, Query Studio, and Event Studio can access 
all types of packages. While Business Insight Advanced, Report Studio, and Event 
Studio are member aware (allow you to work directly with members) , Query Studio is 
not. 

Analysis Studio deals only with dimensional packages. If the package is not 
dimensional, then it will not be available when opening this studio. 
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Business Analytics 



Decide on a Modeling Style 



Recommendation #9 



■ Use standard relational modeling to: 

■ enable basic relational ad hoc querying and 
reporting 

■ Use DMR when you want to: 

■ enable analysis on relational data within Analysis 
Studio 

■ enable drill up and down functionality in reports 
and ad hoc queries 

■ access member functions in the authoring tools 

Cognos. 

software 

© 201 0 IBM Corporation 
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Business Analytics 



Define Regular Dimensions 



■ Consists of one or 
more user-defined 
hierarchies 

■ Each hierarchy 
consists of 

■ levels 

■ keys 

■ captions 

■ attributes 




". Add Hierarchy tin .Add Level X Delete * Pear .All 



Jh 7 Unique Level 

Select a level in the hierarchy control to see the query items. 



fslame 


Role 


Source 


21 


Product Name _membe"Caption 

Product Number _busine$$ttey ... 

Product Description .member Description ,, 
Product Image 

lrT*nr».r4i 1 r4 i f* n Haia 


Products, Product Ne ... 




Product $ Product Dt ... | 





Cognos 

software 
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Hierarchies consist of levels, keys, captions, and attributes. Level information is used to 
roll up measures accurately when performing queries or analyses. Regular dimensions 
require that each level have key and captions specified, and that captions be of the type 
string. These items are used to generate members in the studio data trees (where 
applicable) and retrieve the members at mn time. 

To indicate that the keys in the levels above the current level are not necessary to 
identify the members in a level, select the Unique Level check box. 

If you have a star schema that is in its final reporting form, and your requirement for 
the final model is DMR, you can specify determinants as required and then use the 
Convert to Regular Dimension and Convert to Measure Dimension features to quickly 
create a publishable model. 
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Business Analytics 

Differentiate Determinants and 
Regular Dimensions 



Cognos. 

software 
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Regular Dimensions: 

■ include hierarchies which 
are specified to allow 
OLAP-style analysis 
against relational data 

■ define levels for 
aggregation rollup 

■ are required for Analysis 
Studio 



Determinants: 

■ are specified for query 
subjects 

■ are required for 
dimensions with levels of 
granularity that have 
repeating keys 

■ are required for blobs 

■ do not provide OLAP 
functionality 



Determinants allow IBM Cognos to generate the appropriate SQL to aggregate facts 
appropriately (prevent double-counting) . 

Specifying determinants does not provide OLAP functionality or the ability to use the 
metadata in Analysis Studio. 

Regular dimensions specify levels of a hierarchy, but do not control SQL generation 
with respect to applying a group by on keys that repeat for a particular level of 
granularity in the data. The exception to this mle is if you convert a data source query 
subject to a regular dimension. In this case the regular dimension uses joins and the 
defined levels to handle granularity. This means that the hierarchy information is used 
to define the navigation of a hierarchy as well as determinants. 
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Demo 1 : Create Regular Dimensions 



Purpose: 

You have been asked to provide a business view for authors and 
business analysts that will allow them to author OLAP-style 
queries in all the authoring studios. You will accomplish this by 
using DMR techniques. 

Their requirements are to analyze sales and sales target measures 
against products and time. You will begin preparing this business 
view by creating the required regular dimensions. 



Component: Framework Manager 

Project: GO Operational 

Task 1 . Create the top level of a regular dimension for 

products. 

You will organize dimensional objects in the Dimensional View namespace. Once 
the regular and measure dimensions are complete, you can use star schema 
groupings to populate the Presentation View. 

1. In Framework Manager, close any projects that may be open, and then open 
the GO Operational project located at C:\Edcognos\B5152\ 
CBIFM-Start Files \Module 15\GO Operational. 

2. If necessary, log in as User ID admin, and Password Educationl!. 

3. In the Project Viewer pane, create a new namespace under GO Operational 
Model called Dimensional View. 
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4. Drag the new namespace above the Consolidation View namespace. 
The results appear as follows: 



G GO Operational 



U 0 Operational Model 



i+j- Presentation View 



B j Dimensional View! 



El- B Consolidation View 



0- 0 q Foundation Objects View 



5. Right-click Dimensional View, point to Create, and then click Regular 
Dimension. 



6. In the Available items pane, expand Consolidation View>Products. 

7. Drag Product Line into the Hierarchies pane, right-click the top Product 
Line in the hierarchy column, and then click Rename. 

8. Type Products, and then press Enter. 

9. Rename Product Line(All) to Product (All). 

1 0. In the Hierarchies pane, click the Product Line level, in the Available items 
pane, expand the Codes query item folder, and then drag Product Line Code 
to the bottom right pane ("Select a level. . .") below Product Line. 

You are prompted to select a role. 

1 1 . Select _businessKey. 
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Task 2. Create remaining levels for the Products regular 

dimension. 

1 . Drag Product Type below Product Line in the Hierarchies pane. 

2. Drag Product Type Code to the bottom right pane, select JbusinessKey as 
the role, and then click the Unique Level check box above. 

Selecting Unique Level indicates to IBM Cognos that this level does not require 
the level above it for uniqueness. 

3. Drag Product Name below Product Type in the Hierarchies pane, and then 
rename this level to Product. 

4. Drag Product Number to the bottom right panel and set it as the 

JbusinessKey. 

5. Drag Product Description to the bottom right pane and set it as 

_memberDescription. 

6. Click Product Image, Shift+click Gross Margin, and then drag the selected 
items to the bottom right pane. 

The Product level is the lowest level of the hierarchy and is also represented by 
a unique key, in this case, Product Number. You will specify this level as unique 
as well. 
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7. Select the Unique Level check box. 
The results appear as follows: 



^ Unique Level 

Select a level in the hierarchy control to see the query items. 


Name Role 


S ounce 


Product Name _memberCaption 

Product Number _businessKey 

Product Description _memberDescription 

Product Image 

Introduction Date 

Discontinued Date 

Production Cost 

Gross Margin 


... 


Products. Product N ame 
Products. Codes. Product N umber 
Products. Product D escription 
Products. Product Image 
Products. 1 ntroduction D ate 
Products. D iscontinued D ate 
Products. Production Cost 
Products. Gross Margin 


_mJ 



With this data, product names repeat in certain instances because there may be 
more than one color associated with the product. Sunglasses for instance come 
in several colors. In order to make the data understandable, you will concatenate 
the product number with the product name in the member caption. 

8. In the Product Name row, click the ellipses in the Source column. 

9. At the end of the expression, type | | ’ - ’ | | cast(, from the Available 
Components pane, add Product Number to the end of the expression, and 
then type , VARCH AR(6) ) . 

The results appear as follows: 

[Consolidation View]. [Products]. [Product Name] | | | | cast([Dimensional 

View] . [New Dimension] . [Products] . [Product] . [Product Number] , 
VARCHAR(6)) 

10. Click OK, and then rename Product Name to Product Caption. 
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11. Click OK, rename the new dimension to Products, and then save the project. 
The results appear as follows: 



- 15 Dimensional View 



-l-Tt* Products 
| - Products 

I *■ Product (All) 

■EEI Product Line 
53 Product Type 
1+ Mi Product 



Task 3. Create a regular dimension from the time dimension. 

1 . Create a Time regular dimension as follows: 

• Create a new Regular Dimension in Dimensional View. 

• From Consolidation View>Time, drag Year, Quarter Key, Month Key, 
and Day Key into the Hierarchies pane. 

• Rename the levels as follows: Time, Time (All), Year, Quarter, Month, 
Day. 



For Quarter, Month, and Day levels, select the Unique Level check box. 



• For Year through Day levels, set or ensure the Role is _businessKey. 

• For Month, drag Month (numeric) to the bottom right pane with no role. 

• Click OK and then rename the regular dimension to Time. 

2. Right-click Time, click Verify Selected Objects, and then click Verify Model. 

Four error messages appear, indicating that the levels do not have captions 
specified. You will set Year in the Year level as both business key and caption. 
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3. Click Close, and then double-click Time to re-open the Dimension 
Definition dialog box. 

4. In the Hierarchies pane, click Year, and then, in the bottom pane, click the 
ellipsis (. . .) in the Role column. 

5. Select _memberCaption, click Close, and then click OK. 

6. Right-click Time, click Verify Selected Objects, and then Verify Model. 

There are still four errors. The error related to the Year level, however, has 
changed. It indicates that you cannot assign the _memberCaption role to a data 
type that is not "string". You will fix this in the next task. 

7. Click Close, and then save the project. 

Task 4. Create string calculations for member captions. 

1 . In the Dimensional View namespace, double-click Time to re-open the 

Dimension Definition dialog box. 

2. In the Hierarchies pane, click Year, and then clear the _memberCaption 
check box in the Role dialog box. 

3. Click Close, and with Year still selected, click Add in the bottom right corner. 

4. In the Name box, type Year Caption, and then, in the Expression definition 
pane, type cast(. 

5. In the Available Components pane, expand Consolidation View>Time. 

6. Double-click Year to add it to the Expression definition pane, and then type 
the following: , VARCH AR(4)) . 

The results appear as follows: 

cast([Consolidation View]. [Time]. [Year] , VARCHAR(4)) 

7. Click Test Sample to verify the results, click OK, and then set the Role for 
Year Caption to _memberCaption. 
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8. Repeat steps 3 to 7 to create the following calculations to act as the member 



caption for their respective levels with the appropriate expression: 



Calculation 

Name 


Expression 


Quarter 

Caption 


cast( [Consolidation View] . [Time] . [Year] ,VARCHAR(4)) 
| | * Q f | | cast( [Consolidation View]. [Time]. [Quarter], 
VARCHAR (2)) 


Month 

Caption 


[Consolidation View] . [Time] . [Month] 


Day 

Caption 


cast( [Consolidation View]. [Time]. [Date], VARCHAR (10)) 



9. Click OK, and then verify the selected object. 

There are no errors. 

10. Save the project, and leave Framework Manager open for the following 
workshop. 

Results: 

By creating regular dimensions, you started to develop a DMR 
model that will be used in a new business view to meet OLAP-style 
querying requirements. 
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Workshop 1 : Create a Regular Dimension 



You have been asked to add another dimension for the new Dimensional View. 
Authors must be able to analyze staff as well as products and time against sales and 
sales target measures. 

To accomplish this: 

• Create a regular dimension called Staff by Location based on the Staff by 

Location query subject in the Consolidation View. 

• Create a hierarchy called Staff by Location with the following levels and 

attributes: 

• Staff by Location (All) 

• Staff Region 

• Staff Region Code (business key), Staff Region (member caption, renamed 
to Staff Region Caption) 

• Staff Country (unique level) 

• Staff Country Code (business key), Staff Country (member caption, 
renamed to Staff Country Caption) 

• Staff City (unique level) 

• Staff Branch Code (business key), Staff City (member caption, renamed to 
Staff City Caption), Staff Address 1 (no role), Staff Address 2 (no role), 
Staff Prov/State (no role), Staff Postal Zone (no role) 
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Staff Name (unique level) 

• Sales Staff Code (business key), Staff Full Name (member caption, 
renamed to Staff Name Caption), First Name (no role), Last Name (no 
role), Work Phone (no role), Extension (no role), Fax (no role), Email (no 
role), Manager (no role), Position (no role) 

For more detailed information outlined as tasks, see the Task Table on the next page. 

For the final query results, see the Workshop Results section that follows the Task Table. 
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Workshop 1: Task Table 



Task 


Where to Work 


Hints 


1 . Create a 
regular 
dimension 
named Staff 
by Location. 


Project Viewer 
pane, Dimension 
View, Dimension 
Definition dialog 
box 


• Create a new regular dimension in 
Dimensional View. 

• Add the following levels from 
Consolidation View>Staff by Location: 
Staff Region, Staff Country, Staff City, 
Staff Full Name 

• Rename the hierarchy and the top level 
to Staff by Location and Staff by 
Location (All). 

• Rename the Staff Full Name level to 
Staff Name. 

• Set the Staff Country, Staff City, and 
Staff Name levels as unique. 
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2. Fine-tune 
the new 
dimension. 



Project Viewer 
pane, Dimension 
View, Dimension 
Definition dialog 
box 



Staff Region level: 

• ensure Staff Region is the member 
caption, and then rename it to Staff 
Region Caption to maintain your 
naming convention 

• add Staff Region Code as the business 
key 

Staff Country level: 

• ensure Staff Country is the member 
caption, and then rename it to Staff 
Country Caption 

• add Staff Country Code as the 
business key 
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2. (Cont'd) 



• Staff City level: 

• ensure Staff City is the member 
caption, and then rename it to Staff 
City Caption 

• add Staff Branch Code as the business 
key 

• add Staff Address 1, Staff Address 2, 
Staff Prov/State, Staff Postal Zone, 
(no role for each) 

• Staff Name level: 

• ensure Staff Full Name is the member 
caption, and then rename it to Staff 
Name Caption 

• add Sales Staff Code as the business 
key 

• add First Name, Last Name, Work 
Phone, Extension, Fax, Email, 
Position, Manager (no role for each) 

• Rename the new dimension to Staff by 

Location, organize alphabetically, and 

then save the project. 
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Workshop 1: Workshop Results 



Your Staff by Location hierarchy appears as shown below: 



Hierarchies: 



Staff by Location 
Staff by Location (All) 
Staff Region 
Staff Country 
Staff City 
Staff Name 
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Workshop 1 : Workshop Results 



Your Regular Dimension, when finished and expanded, appears in the Project Viewer 
as shown below: 



- r F Staff by Location 



- 



- 



Staff by Location 
53 Staff by Location (All) 

53 Staff Region 

j Staff Region Caption 
| Staff Region Code 
Staff Country 
] Staff Country Caption 
| Staff Country Code 



Staff City 

j Staff City Caption 
] Staff Branch Code 
\ Staff Address 1 
| Staff Address 2 
\ Staff Prov/State 
| Staff Postal Zone 
Staff Name 

| Staff Name Caption 
\ Sales Staff Code 
j First Name 
j Last Name 
j Work Phone 
j Extension 
] Fax 
j Email 
j Position 
Manager 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



15-25 





I B M 



COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Business Analytics ^== 

Define Measure Dimensions 

■ A logical collection of facts which enables OLAP-style 
analytical querying 

■ Related to regular dimensions within scope 

■ Can be created from: 

■ a single table in a database 

■ multiple tables across 
multiple databases 
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Sales Fact 
£ — Revenue 

L Quantity 
L Unit Cost 
EL Unit Price 
L Unit Sale Price 
L, Gross Profit 

^ M^rnin 



Gognos 

software 



Measure Dimensions are related to Regular Dimensions through scope relationships, 
that define at what levels a measure is in scope. However, underlying join relationships 
are required to generate the SQL that is sent to the data source. 
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Business Analytics 

Define Scope Relationships 



■ Exist between measure 
dimensions and regular 
dimensions 

■ Define the dimensions, 
hierarchies and levels in 
scope for measures 

■ Can be created, modified 
deleted 




A scope relationship is automatically created between a dimension and a measure 
dimension whose underlying query subjects have a valid JOIN relationship defined. 

Scope relationships are required between measures and their related dimensions to 
achieve predictable rollups. 

Scope relationships are not the same as join relationships. They do not impact the 
WHERE clause of the generated SQL, but rather which levels in a dimension are 
available for reporting for a particular measure. 

Scope relationships define which regular dimensions are included by default in star 
schema groupings. 
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Business Analytics 

Edit DMR in the Dimension Map 

■ View, create, or modify: 

■ regular or measure dimensions 

■ hierarchies or levels 

■ scope relationships 



Cognos* 

software 
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■= Explorer ^ Diagram QJJ Dimension Map | 



Dimensions - Scope Mode (Multiple} Measures Attr 



Products 


Staff by Location 


Time 


3 Id Sales Fact 


Products 


Staff by Location 


Tima 


Revenue 
EL Quantity' 
Unit Cost 


Product (All} 


Staff by Location (.All) 


Tim e (M) 


Product line 


Staff Region 


Year 


fL. Unit Price 
IL Unit Sale Price 
Gross Profit 


Product Type 


Staff Country 


Quarter 


Products 


Staff Gty 


Month _ 

- IP Sales Taraet Fact! 




Staff Marne 


Day 


PL Sales Ta-iget 



The Dimension Map view displays all regular and measure dimensions contained in a 
namespace and can be directly modified in this view. 

If a measure is not in scope for a particular level of a regular dimension, you will see 
blank values in Analysis Studio, or repeating values (based on the values found at the 
parent level) in Query Studio or Report Viewer, but the values are not double counted. 



You can edit scope relationships for either measure dimensions or individual measures 
within a measure dimension (in cases where the fact table has multiple levels of 
granularity) . 
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Demo 2: Create Measure Dimensions, Set Scope, and Create 

a Presentation View 



Purpose: 

To continue the development of the DMR view required by authors 
and business analysts, you will create two measure dimensions, 
one for sales measures and one for sales target measures. 

You will need to specify the scope of the measures and then 
populate a new Presentation view before testing the DMR portion 
of the model. 



Components: Framework Manager, Analysis Studio 

Project: GO Operational 

Package: GO Operational (analysis) 

Task 1 . Create Sales Fact and Sales Target Fact measure 

dimensions. 

1 . Right-click Dimensional View, point to Create, and then click Measure 
Dimension. 

2. In the Model Objects pane, expand Consolidation View and Sales Fact. 

3. Click Revenue, Shift+ click Margin, and then drag all the selected measures to 
the Measures pane. 

4. Click OK, rename the new measure dimension to Sales Fact, and then move it 
above Products. 

5. Repeat steps 1 to 4 to create a measure dimension called Sales Target Fact 
based on the Sales Target Fact data source query subject in Consolidation 
View. Select only the Sales Target measure and move the new measure 
dimension below the Sales Fact measure dimension. 
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6. Expand Sales Fact and Sales Target Fact to view the items. 
The results appear as follows: 



Dimensional View 
~ Sales Fact 
L Revenue 
Haa Quantity 
Ln Unit Cost 
[Lj Unit Price 
EL Unit Sale Price 

| i. Gross Profit 

1 [L, Margin 

El Sales Target Fact 

1 i- Sales Target 

^ Products 

T irriiZi 



7. Save the project. 

Task 2. Set scope for the measure dimensions. 



First you will view the scope relationships in the Diagram pane. 

1 . Double-click the Dimensional View namespace to give it focus, and then in 
the middle pane, click Diagram. 

2. From the Diagram menu, click Diagram settings, select Scope 
Relationships, and then click OK 
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3. On the toolbar, click Auto Layout, beside Layout Style, select Star, click 
Apply and then click Close. 

The results appear as follows: 




The facts are joined to their related dimensions through scope relationships. 
These relationships where automatically generated based on the underlying 
relationships in the Foundation Objects View. 
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4 . 



15-32 



Double-click the scope relationship between Time and Sales Target Fact and 
then, in the right pane, click Sales Target Fact. 

The results appear as follows: 




All levels in the Time dimension are highlighted indicating that they are all 
currendy in scope. This is not the case for sales targets since they are at the 
month level. You can set the scope in this dialog or in the Dimension Map 
pane. You will quickly set scope for this measure here but then cancel the 
changes and then set scope in the Dimension Map in order to learn both 
methods. 
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5. Click the Month level, and then click Set Scope. 



The results appear as follows: 




The Day level is no longer highlighted and is now out of scope for the Sales 
Target measure. 

6. Click Cancel, and then in the middle pane, click the Dimension Map tab. 
The results appear as follows: 




The three dimensions appear in the left pane and the measure dimensions 
appear in the right pane. Here you can create, edit, and delete dimensions and 
set scope. 
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IBM C 

7 . 



8 . 



9 . 
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In the Measures pane, click Sales Fact. 
The results appear as follows: 




All regular dimensions are highlighted, indicating that all measures in Sales are in 
scope. 

Click Sales Target. 

Again, the measure is in scope for all dimensions. You will set the scope for 
Sales Target Fact to be at the Month level for Time and Product Type level for 
Products. 



Click Month in the Time dimension, and then on the toolbar, click 



Set Scope 



-I— I 
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10. Click Product Type in the Products dimension, and then on the toolbar, click 

Set Scope. 

The results appear as follows: 



l- Explorer ^ Diagram [QJ Dimension Map 


Dimensions - Scope Mode (Multiple) 


I Measures Attributes 


Products Time Staff by Location 


eHE 


Sales Fact 

Sales Target Fact 


Products 


Time 


Staff Ely Location 




1 S-E 


Product (All) 


Time (All) 


Staff By Location (All) 






Product Line 


Year 


Staff Region 






Product Type 


Quarter 


Staff Country 


Product 


Month 


Staff City 




Day 


Staff Name 







The Day level for the Time dimension and the Products level for the Products 
dimension are no longer highlighted and are out of scope for Sales Target Fact. 
You will now explore the Attributes tab. 

1 1 . Click the Attributes tab. 

The results appear as follows: 



Measures 


Attributes 







Name Role 

Product Type _mernberCaption 

Product Type Code _businessKey 



Here you see the business key, member caption and any other attributes for the 
selected level in the dimension map. You can edit the items here if you wish. 
Each time you select a different level in any of the dimensions, their attributes 
will be displayed here. 

12. Save the project. 
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Task 3. Create a DMR Presentation view using star schema 

groupings. 

1 . In the Presentation View, create a namespace called GO Operational Sales 
(analysis), and then drag below GO Operational Sales (query). 

The results appear as follows: 



=1- 


GO 

i-H 

+ 


Op 

Pre 

■s 


©rational Model 
sentation View 
GO Operational Sales (query) 




■s 


GO Operational Sales (analysis) 




+ 


■s 


Call Center .Application 



2. In the Dimensional View, right-click Sales Fact, and then click Create Star 
Schema Grouping. 

Unlike when you created star schema groupings for relational metadata in the 
Consolidation View, here you do not need to select all the desired dimensions 
along with the fact. This is because Framework Manager uses the scope 
relationships to identify related dimensions. The Consolidation View objects 
have no relationships and therefore you needed to select all required objects. 
Had there been relationships, the Star Schema Grouping wizard would use 
them to detect related objects for the grouping. 

3. Change the namespace name to Sales (analysis), and then click OK. 

4. Drag Sales (analysis) to GO Operational Sales (analysis). 
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5. Repeat steps 2 to 4 with Sales Target Fact to create Sales Targets (analysis). 

The results appear as follows: 



GO Operational Model 



^ Presentation View 



^ GO Operational Sales (query) 



^ GO Operational Sales (analysis) 



Sales (analysis) 



^ Sales Targets (analysis) 



^ Call Center .Application 



6. Save the project. 

Task 4. Create a GO Operational (analysis) package. 

1 . Right-click Packages, point to Create, and then click Package. 

2. In the Name box, type GO Operational (analysis), and then click Next. 

3. Clear the GO Operational Model check box, and then expand 

Presentation View>GO Operational Sales (analysis). 

4. Select Sales (analysis) and Sales Target (analysis). 

The results appear as follows: 



Eli x 



GO Operational Model 



^ Presentation View 



X ^ ‘g GO Operational Sales (query) 



X ^ GO Operational Sales (analysis) 



Sales (analysis) 



Sales Targets (analysis) 



151 - X ^ ‘S Call Center Application 



^ Dimensional View 



Consolidation View 



Foundation Objects View 
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5. Click Finish, click Yes to open the Publish Package wizard, clear the Enable 
model versioning check box, click Next twice, click Publish, and then click 

Finish. 

The Verify Model dialog box appears listing informational messages. 

6. Click Close, and then save the project. 

Task 5. Test the new package in Analysis Studio. 

1 . Launch IBM Cognos Connection, log in, and then launch Analysis Studio 
selecting the GO Operational (analysis) package. 

2. Click Blank Analysis, and then click OK 

3. In the Insertable Objects pane, expand Sales (analysis), and then drag 
Products to the Columns drop zone in the analysis work area. 

4. Drag Time to the Rows drop zone in the analysis work area. 

5. Expand the Sales Fact measure dimension, and then drag Revenue to the 
Measure drop zone in the analysis work area. 

The results appear as follows: 



Revenue 


Camping Equipment 


Mountaineering Equipment 


Personal Accessor 


2004 


$332,936,338.06 




$39 


2005 


5402,757,573. 17 


$107,099,659.94 


$45 


2006 


$500,332,422.33 


$161,039,823.26 


$59 


2007 


$352,910,329.97 


$141,520,649.70 


544 


Time [All!) 


$1,588,036,664.03 


$ 40 9,660 ,132.90 


$1^885 



















6. Click the intersection of Camping Equipment and 2007 once to give 

$352,910,329.97 focus, and then click it again to drill down on both the row 
and the column at the same time. 
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7. Drag Staff by Location below Cooking Gear to nest location under 
Products. 

The results appear as follows: 




You can now further analyze sales in relation to location. 

8. Drill down on the intersection of Cooking Gear, Central Europe and 
2007Q2, and then on June. 

9. In the Insertable Objects pane, expand Sales Target (analysis) > Sales Target 
Fact. 

10. Drag Sales Target to the measures section of the analysis 
to replace the existing measure. 

The results appear as follows: 



Sales target 


Cooking Gear 


France Germany Switzerland 


1 

20070601 




20070602 




20070603 




20070604 





Notice that the measure values are blank. This is because the Sales Target 
measure is not in scope at the Day level. 
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1 1 . Click June to drill up. 

Now values appear because you are at the Month level, which is in scope. 

12. Leave Analysis Studio open for the next demo. 

Results: 

You have successfully completed a dimensionally modeled 
relational model by incorporating measure dimensions and 
specifying scope. 
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Business Analytics 

Member Sorting 

■ You can configure the default sort order for DMR 
members: 

■ metadata (in metadata trees) 

■ data (in reports) 

■ Can sort for OLAP compatibility 

■ for example, ensure the following function returns 
the correct value: 

parallelPeriod([Sales (analysis)]. [Time]. [Time]. [Year], 1, [2007-01-09]) 

Cognos. 

software 
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In a dimensionally modeled relational (DMR) source, by default, the members returned 
under a level are returned in an order dependent on the data source provider. 
Framework Manager allows the modeler to specify sorting options for the levels of a 
hierarchy. 

You can specify how members are sorted in applicable studio metadata trees as well as 
how the members are sorted in report results. 

Various dimensional functions used in Report Studio require the members to be in a 
specific order to achieve predictable results. In these cases, you can also choose to sort 
the members for OLAP compatibility to ensure the members are always returned in the 
same order based on your sort criteria. For example, if you want to compare sales for a 
particular date with the sales of the same day in the previous year (parallelPeriod 
function) , you need to ensure that your time dimension date values are in chronological 
order. 
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Demo 3: Metadata Tree and Member Sorting 



Purpose: 

In order to create a more intuitive and predictable environment for 
authors, you will use some of the new sorting features available in 
Framework Manager. Specifically, you will sort members by 
alphabetical in the metadata tree and in the reports as well as 
configure sorting to be compatible with OLAP style queries. 



Component: Framework Manager, Analysis Studio, Report Studio 



Package: 



GO Operational (analysis) 



Task 1. Examine member sorting in Analysis Studio. 

1. In Analysis Studio, in the data tree, expand Staff by Location> Central 
Europe. 

The results appear as follows: 



- 



□□ 



Staff by Location 



Americas 
Asia Pacific 
Northern Europe 
Central Europe 
+ cm France 
Germany 
Switzerland 
United Kingdom 
Belgium 



This data tree displays members. Notice that the members under Central 
Europe are not sorted alphabetically. 
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2 . 

3. 



Again, the members for Central Europe are not sorted alphabetically. You can 
change this default behavior in Framework Manager by configuring member 
sorting for the regular dimension. 

4. Save the analysis in the GO Operational (analysis) folder as Module 15 - 
Member Sorting Test, and then close Analysis Studio. 

Task 2. Sort members in Framework Manager. 

You will resolve two issues using the member sorting feature. One is to ensure that 
members appear sorted in the data trees in applicable studios and the other is to ensure 
that the time dimension is compatible with dimensional functions. 

1 . In Framework Manager, in the Dimensional View namespace, double-click 
Staff by Location. 



Expand France. 

Again, the values below France are not sorted. 
Examine the data in the analysis. 



Sales Target 


Cooking Gear 


Germany 


Switzerland 


United Kingdom 


Belgium 


Central Europe 


r 

April 


457,000 


271,300 


46 1, 500 


379,200 


2,073,800 


May 


389,000 


213,400 


432,800 


187,800 


1,682,000 


June 


42 5,900 


2 1 3,500 


424,400 


167,300 


1,611,700 


2007 Q2 


1, 28 1,900 


698,200 


1,318,700 


734,300 


5,367,500 



© 2003, 2010, IBM Corporation 15-43 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



2. Click the Members Sort tab. 
The results appear as follows: 




This tab is used to sort members in applicable metadata trees and in reports. 

The panes at the bottom of the dialog are used to configure the sort behavior. 

The options behave as follows: 

Metadata: used to sort members of the level in the metadata tree. 

Data - Only as Default Report Sort: used to sort members in the report 
according to the sort information specified on the levels. 

Data - Always (OLAP compatible): used to provide member relative functions 
with a sorted structure of the members that can be navigated with consistency. 
The members of the level will also be sorted in the metadata tree and reports. 

You will now choose to sort the members of this regular dimension both in the 
data tree and in the reports. 
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3. Under Sorting Options, select both the Metadata and Data check boxes, and 
then click Detect. 





A message appears indicate member sort properties were added to four levels. 
Click OK, and then click Staff Region. 



The results appear as follows: 



Select a Level to Assign Sort Properties: 

Staff by Location 
ij Staff by Locationl'AII) 



Staff Region 



E ■ ^ Staff Country 
Ej-« Staff City 
[Tj "I Staff Name 



Available Data Items: 



D 

1 



Staff Region Caption 
Staff Region Code 



Level Sort Properties: 



Name 


Nulls 


Staff Region C... 


Last 





































Here you can see what criteria are used to sort the members for each level. In 
this case Staff Region Caption (the item used as the member caption) is used to 
sort the members. All the levels are currently using the member caption as the 
sort criteria. If you require the sorting to be applied on another item such as a 
key or some other attribute, you can edit the settings. You can also use multiple 
items in the sorting criteria. For example, you can sort first by name and then by 
code. If there are two identical names, then the code will be used to determine 
which name is displayed first. 



You also have the option on where to display null values in your results. This is 
configured under the Nulls column. Selecting First places the null values at the 
beginning, and Last places the null values at the bottom. Unspecified uses the 
setting defined in the data source. 



Click OK 



You will now ensure that the Time dimension members are compatible with 
dimensional functions. 



6. Double-click Time, and then click the Members Sort tab. 
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7. Under Sorting Options, select both the Metadata and Data check boxes, and 
then select Always (OLAP compatible). 

The results appear as follows: 

r Sorting options 

1^ M etadata (as shown in the member tree) 

1^ Data 

f Only as Default Report Sort 
f* - Always ipLAP compatible; 

8. Click Detect, click OK, and then click OK again. 

9. Save the project. 

Task 3. Re-test member sorting in the studios. 

1 . Publish the GO Operational (analysis) package. 

2. In IBM Cognos Connection, click GO Operational (analysis), and then 
click Module 15 - Member Sorting Test. 

The results appear as follows: 



Sales Target 


Cooking Gear 


Belgium 


France 


Germany 


Switzerland 


United Kingdom 


April 


379,200 


494,800 


467,000 


271,300 


461, 500 


May 


137,800 


459,000 


339,000 


213,400 


432,300 


June 


167,300 


380,600 


425,900 


213,500 


424,400 


200 7Q2 


734,300 


1,334,400 


1,281,900 


698,200 


1,318,700 




< i 




i 







Notice the members in the analysis for Central Europe are now sorted. 
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OBJECTS 





In the data tree, expand Sales Targets (analysis) > Staff by 
Location> Central Europe. 



The results appear as follows: 



Sales Targets [analysis} 


0-1 


^ Sales Target Fact 


+ □ 


□ Products 


0 □□ Staff by Location 


+ nm Americas 


+ e^ Asia Pacific 


p 


- Central Europe 




+ is Belgium 




+ i~a France 




+ □=■ Germany 




+ a Switzerland 




+ nm United Kingdom 



The members are sorted here as well. If you continue to expand the members 
in the data tree for this dimension, you will see all levels are sorted. 



Note: When looking at lower level members in the data tree in Report Studio, 
they will be sorted but there will be logical breaks where the parent level 
changes and the sorting will appear to begin again. For example, if you 
look at members sorted alphabetically at the Product Type Level, you 
will see members sorted alphabetically for Camping Equipment first, 
and then you will next see members sorted alphabetically for Golf 
Equipment. In a pseudo pattern it would look like (abcdefabcdef) . 



Close Analysis Studio. 
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5. Launch Report Studio and create a crosstab report with the following data 
Items from the Sales (analysis) namespace. 

Products Dimension > Products > Product Line to Columns 
Time Dimension > Time > Day to Rows 

Sales Fact Dimension > Revenue to Measures 

6. Run the report. 

The results appear as follows: 



Revenue 


C a flip in g Eq u ip men! Pers o n a 1 Access d ries Outdoor Protects n G o If Eq u ip merit M o u nta ines 


20040000 




20040101 




20040102 




20040103 




20040104 




20040105 




200401 06 




20040107 




200401 OS 




20040109 




20040110 




20040111 

20040112 

20040113 

20040114 

20040115 


320,21 7 ,372 .93 37 ,4 1 4,443 . 06 32 ,20 3 , 330 .47 59 , 1 4 1 ,599 .39 

55,000,71 0.00 53,477,197.59 5474,025.75 52,530,524.05 

5033,110.20 52,1 1 3,9 32 .30 59 1,322.21 5 333,795 .27 

5737,437 .22 5 1 ,353,33 5 . 02 502 ,434 09 542 1 ,035 . 1 1 


200401 16 


5279 ,304 .02 51, 557, 1 9 1 .77 530 ,400 .92 5 59 ,433. 33 


■?nriiini 17 





The dimensional function now returns the correct date from the previous year. 

This is because you configured this regular dimension to sort members for 
OLAP compatibility. This may require more processing, but the results are 
predictable. If performance becomes an issue for large dimension tables using 
this technique, you may consider sorting at the table level. 
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7. Close the browser, and then, in Framework Manager, close and save the 
project. 

8. Close Framework Manager. 

Results: 

By using the new member sorting features in Framework Manager, 
you were able to create a more intuitive and predictable experience 
in the studios for authors. 



Note: This demo illustrated a relative time function (parallelPeriod) . It is worth noting 
that although you can easily perform relative time analysis with dimensional 
functions in Report Studio, ad hoc query users in Query Studio cannot leverage 
this functionality. There are modeling techniques to allow for relative time 
analysis without the use of dimensional functions. Refer to Appendix C for one 

such technique. 
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Business Analytics 

Dimensional Modeling Considerations 

■ Dimensional objects provide an additional layer of 
metadata that enables OLAP behaviors 

■ It may be necessary to employ a form of database 
vendor materialization to improve performance 

■ Build mandatory filters into your model to ensure that 
end users do not accidentally retrieve excessively 
large data sets 



Cognos, 

software 

© 201 0 IBM Corporation 



The rules regarding data volumes that apply to building cubes also apply to a DMR 
source. The key difference is that with filtering strategies, you can perform analysis 
against larger volumes in a relational source than is practical to do with most OLAP 
sources. 
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Business Analytics ^=£-1; 

Modeling Recommendations Review 

1. Define reporting requirements and data access 
strategies 

2. Import only required reporting objects in a phased 
approach and alter as little as possible 

3. Verify relationships and query item properties 

4. Model in freehand to identify query usage 

5. Use model query subjects to control query 
generation and usage and to consolidate metadata 

■ cont'd... & 
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At this point in the course you have touched on all of the modeling recommendations. 
This is a good time to review each of the recommendations in more detail. 

1 . Before beginning any modeling exercises, determine what the reporting 

requirements are. This will help you to find the correct data and define a data 
access strategy. 

Based on available data sources, data volumes, and environmental factors such as 
network speed, hardware processing power, and so on, an appropriate data access 
strategy should be planned and implemented to ensure acceptable response times 
to report requests. 
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2. Import only what is required for reporting and import it in manageable chunks. 
Alter the data source query subjects as litde as possible. Leaving the data source 
query subjects as simple all-inclusive select statements reduces future maintenance. 
For example, when a table has a new column added to it, simply update the data 
source query subject that references it in Framework Manager and the new column 
will appear as a new query item. 

3. Verify that the relationships created during an import reflect those in the data 
source and that the query item properties are set correctly. 

For relationships, notice: 

• cases where a dimension query subject relates to a fact query subject on 
different keys 

• cases where there are multiple valid relationships between query subjects 

• dimension query subjects that belong to multiple hierarchies 

4. Model in freehand to identify modeling challenges and how query subjects are 
used (which query subjects are treated as facts, dimensions, or both). Identifying 
these issues on paper can provide a clear modeling plan. 

5. Begin creating simplified, abstracted model query subjects to resolve modeling 
challenges by: 

• creating aliases where required to control query paths 

• modeling as a virtual star schema to control SQL generation (what is a fact, 
what is a dimension) 

• removing descriptive (dimensional) attributes from fact tables 

• consolidating related information into one model query subject for a cleaner 
presentation (for example, placing all product related query items in one model 
query subject) 
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Business Analytics 

Modeling Recommendations Review (cont'd) 

6. Customize metadata for run time 

7. Specify determinants as required 

8. Resolve multiple ambiguous joins between query 
subjects 

9. Create analysis objects if OLAP-style querying is 
required 

10. Create the business view as a set of star schema 
groupings 

Cognos. 

software 
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6. Customize metadata for runtime by using: 

• parameter maps and session parameters to handle dynamic column or row 
retrieval 

• prompt values and query macros to add mandatory user prompts and security 
filters 

7. Specify determinant information where required to enable accurate aggregation in 
cases where a level of granularity has repeating keys, your data contains BLOBs, or 
you wish to avoid the distinct clause on unique values when grouping or enhance 
performance for regular dimensions. 

8. Resolve any relationship ambiguities, such as multiple joins between two query 
subjects, by deleting surplus joins and by creating role-playing dimensions. 

9. Create regular and measure dimensions if authors need to perform OLAP-style 
queries on relational data. 

10. Use star schema groupings to build logical business groupings in the business view 
and to indicate conformed dimensions based on naming conventions. 
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Business Analytics ^ 

Summary 

■ You should now be able to: 

■ apply dimensional information to relational 
metadata to enable OLAP-style queries 

■ sort members for presentation and predictability 
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Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ describe model types and data entities 

■ define members and member unique names 

■ identify changes that impact a MUN 



Coanos 

software 
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Business Analytics 

Model Types in IBM Cognos 

■ IBM Cognos lets you work with three model types: 

■ relational 

■ dimensionally modeled relational (DMR) 

■ OLAP 



Cognos. 

software 
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Relational models have a basic metadata structure that looks like tables and columns in 
a database. 

DMR and OLAP models display metadata in a multidimensional structure that is 
comprised of dimensions, hierarchies, and measures. 
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Business Analytics 



Data Entities in IBM Cognos 

■ Two data entity types: 

■ values (relational) 

■ members (OI_AP and DMR) 

Relational OLAP/DMR 




When an author creates a report with a relational model, the data values are retrieved 
from rows and columns from a table in the data source. 

Members are entities from a multidimensional data structure. Each member has certain 
properties such as a member key and member caption. The values presented to authors 
and consumers, by default, are the member caption. 

Members also come with additional context that describes their position in the 
multidimensional structure. This context is presented in the member unique name 
(MUN) of each member. 
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Business Analytics 



Work with Members 



Dimension 




Level 



Member 1 



Child 

members 



-8 V Product 

3 A Product ^ 



Hierarchy 






*j Q Members 
±j [**: Prochjct(All> 

S Product line 
- B Members 

a Camping Equipment 
jl cm Cooking Gear 
±1 cm Tents 
±j ™ Sleeping Bags 
±1 *=aa Packs 
±t ca Lanterns 
* Mountaineering Equipment 
+1 op Rope 
±i ™ Safety 

±1 ™ Climbing Accessories 
±1 c=a Tools 

=1 Personal Accessories 



■ Members are located 
in levels of an OLAP or 
DMR structure. 



Members used as data items 
for a report 



Coo&ing Gear 


Rope 


Safety 


Gear > 


<Rope> 


<5afety> 


<Gooking Gear > 


<Rope> 


<5afety> 


<Coctag Gear> 


<Rope> 


<5afety> 
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A dimension contains one or more hierarchies. Each hierarchy contains one or more 
levels. Each level contains one or more members. Each member can have child 
members, which are also found as members of the next lower level in the hierarchy. 

Report Studio and Analysis Studio have members in their data trees and let authors 
work direcdy with the members. These studios are "member- aware". Query Studio is 
not "member-aware" and therefore does not have members in its data tree. 

All studios let authors create reports using levels, which return all members of that 
level. If the studio in which you create reports is "member-aware", members can be 
used independently as data items. 

The metadata items (member attributes) from the multidimensional model can also be 
used for report creation. 
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Business Analytics 

What Makes Up a Member? 

■ Framework Manager DMR source 

■ member key = _businessKey (query item role) 

■ member caption = _memberCaption (query item role) 

■ OLAP source (PowerCube) 

■ member key = Category code 

■ member caption = Category label 

■ OLAP source (DB2) 

■ member key = Member Key 

■ member caption = Member Name 

Cooiiqs* 

software 
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The member key is used to identify a particular member in a multidimensional structure 
and can be used as a value in drill though and master-detail operations. 

The member caption is the name that is displayed for the member. 

Members may also have attributes such as alternate member names or other descriptive 
information. 
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What is a Member Unique Name (MUN)? 

■ Used to locate a member 

■ Referenced in an expression when a member is used: 

■ in a report 

■ in a filter or calculation 

■ for drill -through 



Cognos* 

software 
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Framework Manager modelers, when modeling for DMR, do not create a MUN for a 
member. They specify what will be used as the member key and member caption. The 
member key will be used in the MUN when the MUN is generated at mn time. 

MUNs ensure that members are unique within the multidimensional structure. 
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Business Analytics 

What Makes Up a MUN? 

■ MUN from a PowerCube data source: 

■ [great_outdoor_sales_en] . [Products] . [Products] . 
[Product type]->:[PC].[@MEMBER].[101] 

■ MUN from a Framework Manager DMR data source: 

■ [Sales]. [Product]. [Product]. [Product type] 
->[all]. [2101]. [101] 



Cognos 

software 
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The MUN for the PowerCube data source in the slide example can be identified as 
follows: 



• Level unique name: 

[great_outdoor_sales_en] . [Products] . [Products] . [Product type] 



t 

cube 



t 

hierarchy 



dimension 



A 

level 



• Type of cube: ->: [PC] This represents a PowerCube data source. 

• Vendor specific MUN: [@MEMBER] . [101] . U sed by the data source to locate 
the requested member. 
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Business Analytics 

Changes that Impact a MUN 

■ MUNs can change when: 

■ hierarchies or levels change 

■ member keys change 

■ category codes in PowerCubes 

■ Member Key Column in MSAS cubes 

■ _memberKey role in DMR models 

■ members no longer exist in the data source 

■ a production environment has more members than 
in the test environment 

Goanos. 

software 

©2010 IBM Corporation 

When MUN s change, they impact the reports that directly reference the members to 
which they point. Those MUNs must be identified and fixed in the report. 

For d rill -through scenarios, once a broken MUN reference is fixed, there is potential 
for the report to pass the wrong parameter to the target report. This can occur when 
the member key changes. This is why it is not recommended to change member keys. 

It is critical that business keys are conformed across the business ensuring that that they 
do not change and that there is no need to change them. 

If you understand what changes MUNs, you can model the metadata so that reports 
created in the test/ development environment will run without problems in the 
production environment. 

If a report references a level, which returns all members, then a changed MUN will not 
affect the report. Levels are not members and therefore do not have a MUN. 

It is not recommended for authors to try and manually construct MUNs. 
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Demo 1: Identify How Changes to MUNs Impact Reports 



Purpose: 

Before you move to our production environment, you will use our 
test environment to identify how changes to a model impact reports 
that use members. You will begin by accessing a DMR source to 
create a report. You will create the report using members as data 
items, and then identify a MUN for a member in the report. You will 
then make a change to the model that will impact the MUN, re- 
publish the package, and then re-run the report. You will identify 
how the report is impacted, and subsequently how the MUN is 
impacted. You will then fix the report. 



Framework Manager, Report Studio 

great_outdoors_warehouse 

GO Data Warehouse (analysis) 

For this demo you will use a new model called great_outdoors_warehouse based on a 
reporting database (star schema) for the Great Outdoors Company. 

Taskl. Publish a model. 

1. In Framework Manager, close any projects that may be open, and then open 
the great_outdoors_warehouse project located at 

C:\Edcognos\B5152\CBIFM-Start Files\Module 16\ 
great_outdoors_warehouse. 

2. If prompted, log in as User ID admin, and Password Educationl!. 

3. Publish the GO Data Warehouse (analysis) package, and ensure that the 

Enable model versioning is cleared. 



Components: 

Project: 

Package: 
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2. Create a report using members. 

Launch IBM Cognos Connection, log on, and then launch Report Studio 
selecting the GO Data Warehouse (analysis) package. 

Click Create New, and then double-click Crosstab. 

In the Insertable Objects pane, expand Sales and Marketing (analysis) > 
Sales target> Sales target fact, and then drag the Sales target measure to the 
Measures drop zone in the report. 

Expand Employee (by position) >Employee (by position- 
department) >Position-department (level 1)> 

Members>Executive>Operations>Sales>Level 3 Sales Representative, 

click the first member, Shift+ click the third member, and then drag the 
selected items to the Rows drop zone. 

Drag the Employee (by position-department) (All) level, to the Rows drop 
zone under the existing rows. 

Expand Time dimension>Time dimension, and then drag the Year level to 
the Columns drop zone. 

The results appear as follows: 



Sales target 


<#Y ear # > <#Year # > 


<#Aiko Watanabe#> 


<#1234#> 


<#1234#> 


<#Akemi Yamada#> 


<#1234#> 


<#1234#> 


<#Alessandra Torta#> 


<#1234#> 


<#1234#> 


<#Employee (by position-deparljrient)(All}#> 


<#1234#> 


<# 12.34# > 
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7. On the toolbar, click Run Report 



The results appear as follows: 



Sales target 


2004 | 2005 | 2006 | 2007 


Aiko Watanabe 


12,260,000 


9,370,300 


12,643,200 


4,575,700 


Akemi Yamada 


5,309,700 


3,631,600 


12,219,000 


3,031,660 


Alessandra Torta 


7,403,000 


7,996,500 


3,136,100 


7,529,300 


Employee (by position-department}(All} 


312,335,300 


1,036,923,300 


1,332,553, 100 


1,023,006,340 



The report contains the values of the member items that you added during 
design. 

8. Close Cognos Viewer. 

9. In the Insertable Objects pane, right-click the Aiko Watanabe member, and 
then click Properties. 

Notice the Member Unique Name property: 

[Sales target]. [Employee (by position)]. [Employee (by position- 
department)]. [Employee] -> [all]. [100]. [220 ] . [390 ]. [43639]. [41 16] 

At the very end of the MUN, the _businessKey role value used is 41 1 6. This 
value is based on the Employee key in the data source. 

1 0. Click Close. 

1 1 . Save the report as Module 16 - MUN Test in GO Data Warehouse 
(analysis). 

12. Close Report Studio. 
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Task 3. Change the _businessKey role for a level within a 

dimension. 

1 . In Framework Manager, in the Project Viewer, expand 
go_data_warehouse > Dimensional view. 

2. Double-click Employee (by position-department). 

3. In the Hierarchies pane, click the Employee level. 

In the bottom pane, the _businessKey role is set on Employee key. The values 
represented by this item are those that appear as the member key for the MUN 
of a member as shown earlier. 

4. Under the Role column, click the ellipsis beside Employee code. 

5. In the Specify Roles dialog box, select the _businessKey check box, and then 
click OK to the warning message. 

6. Click Close, and then click OK. 

7. Save the project in C:\Edcognos\B5152\Course_Project\Great Outdoors 
Warehouse, and then re-publish the GO Data Warehouse (analysis) 

package, overwriting the existing package. 
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Task 4. Examine the impact of a modeling change on the 

MUN for a member. 

1 . In IBM Cognos Connection, on the root of Public Folders, click the GO 
Data Warehouse (analysis) folder, and then click the Module 16 - MUN 
Test report. 

The results appear as follows: 



Sales target 


2004 


2005 


2006 


2007 


Employee (by position-departmentJCAll) 


312,085,300 


1,036,923,300 


1,332,553, 100 


1,023,006,340 



Data appears to be missing. The report does not contain the values of the 
member items that you added during design. It contains only the values for the 
metadata item you added (Employee(by position-department) (All)). The report 
is running against the most recent version of the package. 
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2 . 

3. 





At the top of the page, click Open with Report Studio 
then click OK again. 




, click OK, and 



In the Insertable Objects pane, expand Sales and Marketing (analysis) > 
Sales target>Employee (by position) >Employee (by position- 
department) >Position-department (level 1)> Members > Executive > 
Operations>Sales>Level 3 Sales Representative. 



Right-click the Aiko Wantanabe member, and then click Properties. 

Notice the Member Unique Name property. At the very end of the MUN, the 
_businessKey role value used now is 10572. This value is based on the 
Employee code in the data source. This MUN is now different based on the 
change you made to the model. The current employee members in the report 
layout are associated with MUNs that no longer exist and therefore are not 
returned in the report. 



To correct this you must replace the existing members in the report layout with 
the current members from the Insertable Objects pane. 

Click Close, delete the members in the report layout, and then add the same 
members back into the report layout from the Insertable objects pane. 
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6. Run the report. 



The results appear as follows: 



Sales target 


2004 | 2005 | 2006 | 2DQ7 


Aiko Watanabe 


12,260,000 


9,370,300 


12,643,200 


4,575, 7DQ 


Akemi Yamada 


5,309,700 


3,631,600 


12,219,000 


3,031,660 


Alessandra Torta 


7,403,000 


7,996,500 


3,136,100 


7,529,300 


Employee {by position-department)(All) 


312,335,300 


1,036,923,300 


1,332,553, 100 


1,023,006,340 



The rows are now returned appropriately. 



Note: If you have calculations based on members in the report and their 

MUN s change, you will need to go into the query and manually delete 
the members referenced in the calculation before adding the new 
members to the report. This way your calculations will continue to work 
by referencing the new members. 

7. Close all browser windows, close and save the project in Framework Manager. 

Results: 

You have identified how changes you make to your model can 
impact reports that use members. Specifically, you identified how a 
report can be impacted when the change you make impacts the 
MUN for a member in a report. This stresses the importance of using 
the appropriate business key right from the beginning so that 
reports are not broken and will help you model properly before you 
move to a production environment. 
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Business Analytics 

Summary 

■ You should now be able to: 

■ describe model types and data entities 

■ define members and member unique names 

■ identify changes that impact a MUN 



Coejnos 

software 
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Business Analytics ^ 

Objectives 

■ At the end of this module, you should be able to: 

■ identify conformed values between data sources 

■ define a report drill through 

■ define a package-based drill through 

■ identify drill-through values 



Coanos* 

software 
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Conform Values 



To relate information between data sources, values 
and types must match. 



IBM Cognos Transformer 



Framework Manager 



Category code 

for Camping Equipment =(l) 




DMR 




_businessKey 

for Camping Equipment =(l) 


or \ 




Relational 


Source value \ 


Product line .ode 


for Camping Equipment =(1 




for Camping Equipment =@ 



Conformed values for like dimensions 



Coanos. 

software 
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If the values are not conformed for like dimensions (dimensions that represent the 
same data), then tasks such as creating master-detail reports and drill- through 
definitions will be restricted since data cannot be related on common values. 

You should ensure that values are conformed and the data types match early in the 
modeling process to avoid future changes that impact reports and d rill -through 
definitions. 

It is ideal to have these conformed values in the data source and optimized for 
reporting so they are available to all modeling tools and reporting environments. 
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Business Analytics 



What is Drill-Through? 

Source Report 



Revenue 


2004 


2005 


2006 


Camping Equipment 


$20,471,328.88 


$31,373,606.46 


$37,869,055.58 


Mountaineering Equipment 




$9,642,674.54^ 


$11,248,676.06 


Personal Accessories 


$7,144,79725^-^^^ 


$10,955,708.04 


$13,793,960.30 


Outdoor Protection 


$^*§^56.24 


$988,230.64 


$646,428.04 


Golf Equipment 


$5,597,980.86 


$9,598,268.88 


$10,709,215.84 



Target Report 



Year 


Month 


Product line 


Product type 


Product name 


Revenue 


2005 


1 


Mountaineerin 
g Equipment 


Climbing 

Accessories 


Firefly Charger 


$15,367.16 










Firefly Climbing Lamp 


$6,064.14 










Granite Belay 


$29,334.24 










Granite Carabiner 


$4,024.90 










Granite Chalk Bag 


$2,306.82 










Granite Pulley 


$12,538.96 








Climbing 

Accessories 


$69,636.22 

©20 
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Drill through lets a report consumer move from one report to another to focus on a 
specific area of interest. 

Drill through is accomplished by passing parameters from one report to another and 
using those parameters to filter the results. These values must be conformed to get 
expected results. 
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Business Analytics =^==^? 

IBM Cognos Drill-Through Definition 
Types 

■ Two commonly used types of drill-through definitions: 

■ report-based 

■ package-based (parameter-driven, and dynamic) 

■ Add parameterized filters in target reports to focus 
results 



Cognos* 

software 
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There are two distinct types of drill through available within IBM Cognos. These are 
not the only ways of performing a drill through; however, they are the most common 
ways. 

• A report-based drill-through definition is specific to a source report in which one 
or more drill paths are defined to one or more target reports. This type of 
definition is created in Report Studio. 

• A package-based drill-through definition lets a consumer perform a d rill through 
from any report based on a package to any other report in IBM Cognos. This 
type of definition is created in IBM Cognos Connection and can be either 
parameter-driven or dynamic in nature. When dynamic, the target report does not 
need filters since they will be generated dynamically at run time. 

Parameterized filters ("Go To" parameter in Analysis Studio) are not required, but they 
are useful in returning a customized and focused view of the data based on your source 
d rill -through value(s). Otherwise, the report is mn without context from the source 
report. 
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Demo 1: Create Drill-Through Definitions 



Purpose: 

As a modeler, you need to understand basic drill-through 
functionality, so, you will create a simple report-based drill-through 
definition to drill from one report to another. 

You will create a target report with a prompt value filter, and then a 
source report with a report-based drill-through definition. You will 
also use the target report in a package-based drill-through 
definition. 



Framework Manager, Report Studio, IBM Cognos Connection 
great_outdoors_warehouse 

GO Data Warehouse (query), GO Data Warehouse (analysis) 

Task 1. Publish package. 

1. In Framework Manager, close any projects that may be open, and then open 
the great_outdoors_warehouse project located at C:\Edcognos\B5152\ 
CBIFM-Start Files\Module 17\great_outdoors_warehouse. 

This is an untouched version of the project. 

2. Publish the GO Data Warehouse (analysis) and GO Data Warehouse 
(query) packages. 

Click Yes, if a warning message displays. 

3. Save and close the project. 



Components: 

Project: 

Packages: 
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2. Create the target report. 

Launch IBM Cognos Connection, log on, and launch Report Studio 
selecting the GO Data Warehouse (query) package. 

Create a new List report. 

Expand Sales and Marketing (query)>Sales (query), and then add the 
following items to the report: 



Query Subject 


Query Item 


Employee by region 


Region 


Product 


Product line 




Product type 




Product name 


Sales fact 


Revenue 



4. In the work area, click the Region column header, and then Shift+ click 

Product type. 



Task 

1 . 

2 . 

3. 



5. On the toolbar, click Group 
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MANAGER 




Click the Revenue column header, on the toolbar click Summarize 
then click T otal. 




The results appear as follows: 



•1 i 

Reg io n 


Product line 


Product type 


Product name 


77777777777777777777777777 

■Resell iift: 


<| Region> 


<| Product lino 


<8 Product typo 


< Prod uct name> 


-=: Revenue:- 


<Pirod uct type> 


- Total 


<T otal ( Revenue )> 


< Pro duct typo 


< Prod uct name> 


-=: Revenue:- 


<Product type> 


- Total 


<Total( Reven ue]> 


cProduct line> 


- Total 




<T otal ( Revenue^ 


< Product line> 


<Prod uct typo 


< Pro duct namo 


< Reven ue> 


<Product type> 


- Total 


<T otal ( Reven ue)> 


<Product typo 


<Product namo 


< Reven ue> 


<Product type> 


- Total 


<T otal ( Reven ue)> 


^Product line> 


- Total 




<T otal ( Reven ue)> 


| <Region> - 


Total 






<T otal ( Reven ue)> 




Task 3. Create filters to be used as drill-through parameters. 



1 . With the Revenue column header selected, on the toolbar, click Filters 
then select Edit Filters. 



v 



2. Click Add 




, click Advanced, and then click OK. 



3. Under the Available Components pane, click the Data Items tab 
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4. In the Available Components pane, double-click Region to add it to the 

Expression Definition pane. 

5. In the Expression Definition pane, at the end of the expression, type = 

PRegion?. 

The results appear as follows: 

[Region] = PRegion? 

You will create another filter. 

6. Click OK, and then click Add. 

7. Click Advanced, and then click OK. 

8. Expand Sales and Marketing (query)>Sales (query) >Product> Codes, and 
then double-click Product line code to add it to the Expression Definition 
pane. 

9. At the end of the expression, type = PProduct line code?. 

The results appear as follows: 

[Sales (query)] . [Product] . [Product line code] = PProduct line code? 

You will now make the filters optional. By making them optional, users are not 
forced to provide a value when running the report. This makes the report more 
flexible by giving consumers the choice to see all records or focus their results. 

10. Click OK, and then under Usage, click Optional. 

11. Click the [Region] = PRegion? filter, and then under Usage, click Optional. 

12. Click OK 

13. From the File menu, click Save. 

14. Save the report as Revenue by Year and Product (Detail). 
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Task 4. Create the source report. 

You will now create a source report based on the GO Data Warehouse (analysis) 
package which is modeled dimensionally (regular and measure dimensions) . 

1. From the File menu, click New, and then double-click Crosstab. 

2. From the File menu, click Report Package, under Public Folders, click GO 
Data Warehouse (analysis), and then click OK 

3. Click OK again. 

4. Expand Sales and Marketing (analysis) >Sales>Product>Product, and 

then drag the Product line level to the Rows drop zone. 

5. Expand Employee (by region) >Employee (by region), and then drag the 
Region level to the Columns drop zone on the report. 

6. Expand Sales fact, and then drag Revenue to Measures drop zone on the 
report. 

The results appear as follows: 



i d 

Revenue 


<^Rsgion#> -=:#RegiDn#> 


cEFToduct line#> 


<£1234#> <#1234#> 


cEPmduct line#> 


<£1234#> <#1234#> 



Task 5. Create and test a report-based drill through. 

1. Right-click one of the Revenue cells in the crosstab report, click Select Fact 
Cells, and then on the toolbar click Drill-Through Definitions 





2. Click New Drill-Through Definition LE J, beside the Report box, click the 
ellipsis, and then double-click Revenue By Year and Product (Detail). 
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Under Parameters, click Edit 




and then select the Method. Value, and 



Property to Pass items as shown below: 



Parameters 



Name 


Type 


Required 


Multi-select 


Method 


Value 


Property to Pass 


Product line code 


Number 






Pass data item value 


T gf Product line 


- 


Business Key 


Region 


String 






Pass data item value 


T gf Region 


▼ Member Caption 



The Property to Pass item allows you to select which portion of the member 
(when dealing with a dimensional source) you would like to pass to the target 
report such as the Member Unique Name (MUN), Member Caption or 
Business Key. In this case you are passing the Business Key for Product line 
and Member Caption for Region to match the values and data types in the 
target relational report. These values are conformed between the two sources. 



Other options include passing the Parent Unique Name (the parent MUN), 
Dimension Unique Name, and so on. Some of these items can be used for 
advanced reporting techniques. One example is to provide contextual 
information in the target report. You can display which dimension, hierarchy, 
and level a member came from in the source report. Another example is a target 
report with the following calculation: 

bottomCount (#promptCLevel Name', 'token 1 )#, 2, [Revenue]) 



This expression will return the bottom two performing members of a level 
based on revenue. The level name in this case is provided through a prompt 
macro. You can pass the target report the Level Unique Name from the source 
report to determine which level will be evaluated for the bottom two members. 



Please see the documentation for more details. 



4. Click OK, and then click OK again. 
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7 . 

8 . 



On the toolbar, click Run Report 



> 



The results appear as follows: 



Revenue 


Americas 


Asia Pacific 


Northern Europe 


Central Europe 


Southern Europe 


Camping Equipment 


4S1 .445.731 .04 


421 .339 391 .62 


133.351.396.33 


343 645 343 36 


161 .454.246.13 


Mountaineering Equipment 


123.127.397.33 


107.505.775.01 


46.031.103.04 


33 051 532 39 


44.334.31 5.03 


Pens o n a 1 Access o ries 


1 32. 249.053. 93 


116.71 5 219 51 


49.325 . 91 3.97 


1.540.675.699.15 


46.20 7. 41 6. 1 7 


Outdoor Protection 


23.002.647.63 


1 9.716.016.32 


3.346.431 .17 


17.433.370.77 


7.440.323.31 


Golf Equipment 


— ar n n n, jvrs r rtrL 

21 ? .232.995.22 


1 93.677.373.33 


34.424.300.9 


153.632.333.39 


77.41 3.364.7 







Click 123,127,397.88 at the intersection of Mountaineering Equipment and 
Americas to drill through to the detail report. 

The report appears as shown below: 




The report is filtered on the Mountaineering Equipment and Americas. 

Close IBM Cognos Viewer, and then save the source crosstab report as 

Revenue by Year and Product (Summary). 



Close Report Studio. 
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Task 6. Create a package-based drill through. 

You can also create a package-based drill-through definition to allow any report 

from a package to drill through to a target. 

1 . In IBM Cognos Connection, from the Launch menu, click Drill-through 
Definitions. 

2. Click the GO Data Warehouse (analysis) package. 

gs* 

3. On the toolbar, click New Drill-through Definition _ I - 

4. In the Name box, type Revenue by Year and Product (Detail), and then 
click Next. 

5. Click Set the target, and then click Select a Report. 

6. Click Public Folders, click GO Data Warehouse (query), and then select 
Revenue by Year and Product (Detail). 

7. Click OK, click Next, and then under Parameter mapping, for the Product 
line code target parameter, click map to metadata. 

8. Expand Sales and Marketing (analysis) >Sales>Product, click Product 
line, and then click OK 

9. For the Region target parameter, click map to metadata, expand Sales and 
Marketing (analysis)>Sales>Employee (by region), and then click Region. 

10. Click OK, and then under Source metadata item properties, select the items 
as shown below: 



Target parameter 


| Type Required 


Multi- select Source metadata item 




Source metadata item properties 


Product line code 


Number 


[Sales] , [product] . [Product] . [Product line] JK 




Business Key 




Region 


Text 


[Sales] , [Employee (by region)] . [Employee by region] , [Region] 


# X 


Member Caption 





11. Click Finish. 
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Task 7. Test package-based drill through in Query Studio. 

1. Launch Query Studio, and then select the GO Data Warehouse (analysis) 

package. 

2. Expand Sales and Marketing (analysis) > Sales, and then add the following 
items to the report: 



Query Subject 


Query Item 


Employee (by region) 


Region 


Product 


Product line 


Sales fact 


Revenue 



The results appear as follows: 



Region 


Product line 


Revenue 


Americas 


Campina Equipment 


431,445,731.04 


Americas 


Mountaineer™ Equipment 


123, 127,397.33 


Americas 


Personal Accessories 


132,249,058.98 


Americas 


Outdoor Protection 


23,002,647.68 


Americas 


Golf Equipment 


217,262,995.22 


Asia Pacific 


Campinq Equipment 


421,639,39 L 62 


Asia Pacific 


Mountaineer™ Equipment 


107,505,775.01 


Asia Pacific 


Personal Accessories 


116,715,219.51 


Asia Pacific 


Outdoor Protection 


19,716,013.32 


Asia Pacific 


Golf Equipment 


193,677,373.63 


Northern Europe 


Campinq Equipment 


130,351,396.88 


Northern Europe 


Mountaineer™ Equipment 


46,091,103.04 


Northern Europe 


Personal Accessories 


49,325,913.97 


Mr.r+born Pi i r fi i~i ■=. 


mu i + id i- i - . r Drrvlm*-lmnn 


q jt-i it 
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3. Beside Americas, right-click Personal Accessories, point to Go To, and then 
click Related Links. 

4. Click Revenue by Year and Product (Detail). 

The results appear as follows: 



Region 



Product line 



Product type 


Prod u ct n a me 


Revenue 


B n oculars 


Seeker 35 


3,374,564 


Seeker 5 0 


6,1 13.790.33 


Seeker Extreme 


5,696,333.33 


Seeker M in i 


3,672,232.2 


Binoculars 


-Total 


24,362,029.96 


Eyewear 


Polar Extreme 


999,944.29 




Polar Ice 


3,420,270.02 




Polar Sports 


7,937,330.33 




Polar Sun 


7,644.731.52 




Polar Wave 


335,230.51 


Eyewear - Total 




Knives 


Bear Edge 


3,361,434.35 




Bear Survival Edge 


3,091,356.36 




Double Edge 


3,573.659.12 




Edge Extreme 


10,640,797.71 




Single Edge 


13,591,099.26 


Knives - Total 


34,753,397.3 


Navigation 


Glacier Basic 


3,796,651.34 



The report is filtered on the year Personal Accessories and Americas. 
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5. Close IBM Cognos Viewer, return to Query Studio, and then save the report 

as Module 17 Demo 1 Drill Through. 

6. Click Return, close Framework Manager, and leave IBM Cognos 

Connection open for the next demo. 



Results: 

By creating and testing simple drill-through definitions, you can see 
how parameters are passed from one report to another to focus the 
results of the target report. 
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Business Analytics 

Considerations for Drill-Through 
Definitions 

■ Things to consider before creating drill-through 
definitions include: 

■ conformed drill-through values 

■ unique business keys across all levels for IBM 
Cog nos PowerCubes 



Cognos, 

software 

©2010 IBM Corporation 



The value passed from the source report to the target report must match in type and 
content. 

If the values are not conformed then the filter in your target report may return no 
records or records that are not expected. For example, with relational to relational d rill 
through, the value that is passed must be the same data type (integer, string, and so on) 
and actually exists in the target data source. If you pass a value of "Americas" to a target 
report that was expecting an integer, there would be a mismatch error. Also, if you 
passed a code of 1234 that represents the Americas but the target data source uses a 
code of 1 for the Americas, you would return either no results or the wrong results. 
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With IBM Cognos, you have the ability to use the Category code value as the member 
key for a PowerCube generated by IBM Cognos Transformer. If the business keys used 
for the category code are not unique across all levels in the PowerCube, Transformer 
will generate a tilde in it, such as 1 — 25. In these cases the value will not match the value 
found in the originating relational source and potentially other data sources. It is 
important for the category codes to be unique throughout the dimension to avoid the 
tilde. Because of this, it is recommended that all business keys be unique across all 
levels in all you data sources if you intend to use PowerCubes in drill through and 
master-detail operations with other sources. 

When drilling from DMR or OLAP to another source, you can choose which portion 
of the member will be passed to match to the value used in the target report. This 
provides a great deal off flexibility when working with multiple data source types. 
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Demo 2: Identify Drill-Through Values 



Purpose: 

You will create a package-based drill-through definition to test 
values passed from an OLAP source to a relational source. By 
testing these values, you can obtain MUN values and compare them 
to the values expected in the target report. 



Components: IBM Cognos Connection, Analysis Studio, Report Studio 

Packages: GO Data Warehouse (query) 

Task 1. Create a package-based drill through for an OLAP 

package. 

1 . In IBM Cognos Connection, from the Launch menu, select Drill-through 
Definitions. 

2. Click Public Folders, and then navigate to Samples > Cubes > Sales and 
Marketing (cube). 

This package is based on an IBM Cognos PowerCube as the data source. 

gs| 

3. On the toolbar, click New Drill-through Definition _ I - 

4. In the Name box, type OLAP to Relational Test, click Next, and then click 
Set the scope. 

You will set the scope of this drill- through definition at the Product line level of 
the Products dimension so that users can only drill through to the target report 
when at that level. 

5. Expand Products, click Product line, and then click OK. 

6. Click Set the target, and then click Select a report. 

7. Click Public Folders, click GO Data Warehouse (query), and then select 
Revenue by Year and Product (Detail). 
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8. Click OK, and then click Next. 

9. Under Parameter mapping, for the Product line code parameter, click map 
to metadata. 

10. Expand Products, click Product line, and then click OK. 

1 1 . For the Region parameter, click map to metadata, expand Retailers, click 
Region, and then click OK. 

12. Click Finish. 

Task 2. Test package-based drill through in Analysis Studio. 

1. From the Launch menu, click Analysis Studio, navigate to Sample>Cubes, 
and then click Sales and Marketing (cube). 

2. Click Default Analysis, and then click OK 

3. From the data tree, drag Retailers to the rows. 



The results appear as follows: 



Revenue 


Camping Equipment 


Personal Accessories 


Outdoor Protection 






593,696,733.33 


23,00. 


Americas 


43 1,445,73 L 04 


Asia Pacific 


421*639,39 L 62 


439,300,120.35 


19,71i 


Northern Europe 


130,351,396.83 


210,603,203.82 


8,34 


Central Europe 


343,645,340.36 


437,336,435.23 


17,431 


Southern Europe 


161,454,246. 13 


204,231,710.00 


7,44 




Retailers 


1,509/036,664.03 


1,005,673,307.70 


75*994 



4. Right-click Personal Accessories, point to Go To, and then click Related 
Links. 
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5. Click OLAP to Relational Test. 

By drilling through directly on Personal Accessories, you are only passing one 
parameter to the target report, in this case the member key value for the 
Product line member Personal Accessories. 

The results appear as follows: 



Region 


Product line 


Product type 


Product name 


Revenue 


Americas 


Personal Accessories 


Binoculars 


Seeker 35 


8., 874, 564 








Seeker 50 


6, 1 18,790.38 








Seeker Extreme 


5,696,383.38 








Seeker Mini 


3,672,292.2 






Binoculars 


24,362,029.96 






Eyewear 


Polar Extreme 


999,944.29 








Polar Ice 


3,420,270.02 








Polar Sports 


7,987,830.88 








Polar Sun 


7,644,731.52 








Polar Wave 


885,230.51 






Eyewear 


20,938,007.22 






Knives 


Bear Edge 


3,861,484.85 








Bear Survival Edge 


3,091,856.36 








Double Edge 


3,573,659.12 








Edge Extreme 


10,640,797.71 








Single Edge 


13,591,099.26 






Knives 


34,758,897.3 






Navigation 


Glacier Basic 


8,796,651.34 



The report is filtered on the Product line code 993 which represents Personal 
Accessories. However, if you page through the report, you will see values are 
returned for all regions. 
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6. Close IBM Cognos Viewer. 

7. In Analysis Studio, at the intersection of Personal Accessories and Asia 
Pacific, right-click 439,800,120.35, point to Go To, and then click Related 
Links. 

8. Click View passed source values. 

This option is only available if you have been granted access. See your 
administrator if you require this option. 

The results appear as follows: 



Pa ssed soy rce va 1 u es: 

Custom URL: 

Package- based Dr ill-th rough access: 
Package search path: 






Selection context 






Item 


1 Display value 


1 Use value 


Revenue 


439 , 300, 120 , 3 5 <A > </A > 


439,800, 120. 35 <A></A> 


Region 


Asia Pacific 


[sales_and_marketing] . [Retailers] . [Retailers] . [Region] ->: [PC] , [©MEMBER] . [740] 


Product line 


Personal Accessories 


[sales_and jmarketingO . [Products] . [Products] . [Product line]->: [PC] . [©MEMBER] , [993] 






More 



These are all the potential values that can be passed and evaluated by the target 
report. The intersection you drilled through on has three elements, Product line, 
Region and Revenue. The target report only has optional filters on Product line 
code and Region. Because you did not specify an item for Source metadata item 
properties, the default behavior is to pass the member key to the relational 
source. 

Notice the member key values in the MUNs. 993 for Personal Accessories and 
740 for Asia Pacific. 993 is a conformed value between the OLAP source and 
the relational source, but 740 is not. 
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Click the arrow 

T arget Mapping. 



beside OLAP to Relational Test, and then click View 



The results appear as follows: 



Parameter mapping: 
Drill through definition:: 
Mapped target parameters: 


Parameter name 


Display va lye 


Use valye 


Product line code 
Region 


Personal Accessories 993 

Asia Pacific 7-3Q 





You can see the display value of the item being passed and the actual value that 
will be passed to the target report. Again, the value for Product line code will 
work as it is conformed, but the use value for Region will not since the target 
report is expecting text. The value 740 will be accepted by the target report as 
possible text, but it does not match any values in the target data. 

10. Click OLAP to Relational Test. 



The results appear as follows: 



Region 


Product line 


Product type 


Product name 


Revenue 







The report returns no data because there are no regions called 740. 

The data types do not match. There are few solutions. 

• You could change the filter in the target report to accept the business key 
instead. 

• You could change the data item being passed to caption instead of the 
member key in the drill-through definition. 

You implement the second option. 

1 1 . Close IBM Cognos Viewer. 
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Task 3. Change the source report parameter to pass the 

member caption. 

1 . In IBM Cognos Connection, click Set Properties for OLAP to Relational 
Test, and then click the Target tab. 

2. Under Parameter mapping, in the Region row, change Source metadata 
item properties to Member Caption. 

3. Click OK 



Task 4. Retest the drill-through definition in Analysis Studio. 





In Analysis Studio, at the intersection of Personal Accessories and Asia 
Pacific, right-click 439,800,120.35, point to Go To, and then click Related 
Links. 



Click the arrow 

T arget Mapping. 



beside OLAP to Relational Test, and then click View 



The results appear as follows: 



Parameter mapping: 
Drill through definition: 
Mapped target parameters: 



Parameter name 


Display value 


j Use value 


Product line code 


Personal Accessories 


993 


Region 


Asia Pacific: 


Asia Pacific 



The Use value for Region is now text and a compatible value with the relational 
target report. 
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3 . 



17-26 



Click OLAP to Relational Test. 



The results appear as follows: 



Region 


Prod u ct line Prod u ct type 


Product name 


Revenue 


Asia Pacific 


Pers o n a 1 Access o ries B in o c j la rs 


Seeker 35 


3,059,753.43 






Seeker 50 


5,499.440.04 






Seeker Extreme 


5,111,979.2 






Seeker Mini 


3,223,053.37 




Binccula 's- 


Total 


21 ,394,236.09 




Eyewear 


Polar Extreme 


374,603.04 






Polar Ice 


3,032.336.12 






Polar Sports 


7. 230, 02 E. 69 






Polar Sun 


6,336,923.26 






Po la r Wave 


732.349.02 




Eyewear -Total 


13,906,297.13 




Knives 


Bear Edge 


3,330,974.73 






Bear Survival Edge 


2,671,570.34 






Double Edge 


3,095,334.16 






Ed ge Extreme 


9,232,660.21 






Single Edge 


11,764,043.31 




Knives -Total 


30|095|0BB.-3- 




Navinatinn 


fllarisr riasin 


7 577 »nR4 



The report is now filtered on both Personal Accessories and Asia Pacific 
because all d rill -through values are conformed. 
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4. Close all browser windows. 

Results: 

By testing values passed from an OLAP source to a relational 
source, you observed techniques to obtain MUN values and 
compared them to the values expected in the target report. 
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Business Analytics ^ 

Summary 

■ You should be able to: 

■ identify conformed values between data sources 

■ define a report drill through 

■ define a package-based drill through 

■ identify drill-through values 



Coanos. 

software 
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Business Analytics =^==E"§: 

Objectives 

■ At the end of this module, you should be able to 
identify: 

■ governors that affect SQL generation 

■ stitch query SQL 

■ conformed and non-conformed dimensions in generated 
SQL 

■ multi-fact/multi-grain stitch query SQL 

■ variances in Report Studio generated SQL 

■ dimensionally modeled relational SQL generation 

■ cross join SQL 

■ various results sets for multi-fact queries ^nos. 

©2010 IBM Corporation 
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Business Analytics 



Explore SQL Generation 



select !_) 


]_ 

*• full outer join 


coalesce(D2.Yearl,D3.Yearl) as Yearl, 
D2. Revenue as Revenue, * 


(select 


Time Dimension. Yearl as Yearl, 


D3.Sales_Target as Sales_Target 
from 

(select 1 


XSUM(Sales_Target.Sales_Target 


for Time_Dimension.Yearl) as 
Sales Target 


Time_Dimension.Yearl as Yearl, ■ 


from 


XSUM(Sales_Fact.Revenue for 


Time Dimension.Yearl) as Revenue 1 




from ■ 


where 

((Time Dimension.Yearl = 


where 1 


Sales_Target.Sales_Year) and 


(Time Dimension. Day Date = ■ 


(Time_Dimension. Month 1 = 


Sales_Fact.Order_Date) 1 


Sales_Target.Sales_Period)) 


group by | 


group by 


Time_Dimension.Yearl . 


Time_Dimension. Yearl 


) D2 _ _ _ 1 


) D3 

on (D2. Yearl = D3.Yearl) 





Cognos, 

software 
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Confusion is a common reaction to the SQL illustrated in the slide example. 

Frequently asked questions are: 

• What is the coalesce function? 

• Why do I see the same columns being selected in two different derived tables? 

• Why do I see a full outer join? 

• What does the XSUM function do? 

These questions and others will be answered throughout this module as you explore 
complex Cognos generated SQL. 



18-4 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 



ADVANCED GENERATED SQL CONCEPTS AND COMPLEX QUERIES 



Business Analytics 



Governors that affect SQL Generation 



Outer Joins (Allow, Deny) 

Cross-Product Joins (Allow, Deny) 

Shortcut Processing (Automatic, Explicit) 

SQL Join Syntax (Explicit, Implicit) 

Grouping of Measure Attributes (Enable, Disable) 

SQL Generation for Level Attributes (Group by, Minimum) 
SQL Generation for Determinant Attributes (Group by, 

Minimum) 



SQL Parameter Syntax (Marker, Literal) 

Use WITH clause when generating SQL (Yes, no) 



Coanos. 

software 
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There are several project governors that can limit queries and affect the SQL generated 
at mn time. Some governors are discussed in more detail in another module. We will 
not go into detail for each governor setting listed above since some are used in rare 
cases. Please refer to the documentation for details on each governor setting. We will 
look at a couple in detail. 

The SQL Join Syntax governor controls how SQL is generated for inner joins. Selecting 
Explicit will generate INNER J OIN syntax, and selecting Implicit will use WHERE 
syntax. 

The Use WITH clause when generating SQL governor lets you choose to use the 
WITH clause with Cognos SQL if your data source supports it. 
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Business Analytics 

Derived Tables 

■ Derived tables: 

■ are aliased sub-selects 

■ enable developers to see values being returned 
without viewing complex SQL 

■ are generated in both Cognos SQL and Native SQL 

Cognos SQL 

select 

from 

(select 

p ) D2^i — 

Derived Table Derived Table Alias software 

©2010 IBM Corporation 



Before examining more complex stitch query SQL, let's take a moment to review 
derived tables. 

A derived table retrieves a record set that fulfills the requirements of the parent query. 
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Business Analytics 



Derived Tables (cont'd) 



select 

coalesce(D2.Yearl,D3.Yearl) as Yearl, 
D2. Revenue as Revenue, 
D3.Sales_Target as Sales_Target 
from 

(select 

Time_Dimension.Yearl as Yearl, 

XSUM(Sales_Fact.Revenue for 
Time_Dimension.Yearl) as Revenue 

from 



where 

(Time_Dimension.Day_Date = 
Sales_Fact.Order_Date) 

group by 

Time_Dimension.Yearl 

)|D2|— — — — — — — 



.full outer join 
(select 

Time_Dimension. Yearl as Yearl, 
XSUM(Sales_Target.Sales_Target 
for Time_Dimension.Yearl) as 
Sales_Target 

from 



where 

((Time_Dimension.Yearl = 
Sales_Target.Sales_Year) and 
(Time_Dimension.Monthl = 
Sa I es_Ta rg et . Sa I es_Per i od ) ) 

group by 

Time_Dimension.Yearl 

Hd3 

on (D2.Yearl = D3.Yearl) 



Coanos 

software 
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Derived tables use alias names that make it easy to see from which query the projected 
items come from. 

In the slide example, we have two derived tables, D2 and D3, which achieve the final 
projections list. 

The derived table alias names are also used in the join statement. 
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Business Analytics 



Identify Stitch Query SQL 

1 

select 



coalesce(D2.Yearl,D3.Yearl) as Yearlj, 
D2. Revenue as Revenue, 
D3.Sales_Target as Sales_Target 



from 



(select 

Time_Dimension.Yearl as Yearl, 

XSUM(Sales_Fact.Revenue tor 
Time_Dimension. Yearl) as Revenue 

from 




“►full outer join 



(qplprt 



where 

(Time_Dimension.Day_Date = 
Sales_Fact.Order_Date) 

group by 

Time_Dimension.Yearl 

) D2 



Time_Dimension. Yearl as Yearl, 
XbUM(baies_ i arget.baies_ i arget 
for Time_Dimension.Yearl) as 
Sales_Target 

from 



where 

((Time_Dimension.Yearl = 
Sales_Target.Sales_Year) and 
(Time_Dimension.Monthl = 
Sales_Target.Sales_Period)) 

group by 

Time_Dimension.Yearl 
) D3 

on (D2.Yearl = D3.Yearl) 



Coanos 

software 
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Stitch queries are used to achieve predictable results for multi-fact queries. 
There are three essential components of a stitch query: 

• coalesce function 

• full outer join 

• multiple queries that query some of the same information 



18-8 ©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 



ADVANCED GENERATED SQL CONCEPTS AND COMPLEX QUERIES 



Business Analytics 



What is a Coalesce Function? 



select 



COalesce(D2. DAY_DATE,D3. DAY_DATE) as DAY_DATE, 
COalesce(D2.0RDER_METH0D,D3.0RDER_METH0D) as ORDER_METHOD, 



Sales Fact 



Returned Items Fact 



DAY_DATE 


ORDER_METHOD 


SALE_TOTAL 


01/01/2005 


E-mail 


$10 


01/02/2005 


Telephone 


$25 


01/03/2005 


Web 


$40 


01/04/2005 


E-mail 


$20 




DAY_DATE 


ORDER_METHOD 


RETU RN_QU ANTITY 


01/01/2005 


E-mail 


2 


01/02/2005 


Telephone 


4 


1 01/10/2005 


Fax 


15 


[ 01/11/2005 


Sales visit 


1 



Report Set 



DAY_DATE 


ORDER_METHOD 


SALE_TOTAL 


RETU RN_QU ANTITY 


01/01/2005 


E-mail 


$10 


2 


01/02/2005 


Telephone 


$25 


4 


01/03/2005 


Web 


$40 




01/04/2005 


E-mail 


$20 




01/10/2005 


Fax 




15 


01/11/2005 


Sales visit 




1 



Coanos. 

software 
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A coalesce function: 

• merges query items that exist on multiple sides of the query 

• indicates that a query item is part of a conformed dimension 

Anything included in the report as a column, filter, or prompt can be treated as a 
conformed dimension, if it is common to the fact items in the query, and may appear as 
a coalesce. 
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Business Analytics 



Non-Conformed Dimensions in Generated SQL 



select 



coalesce(D2.DAY_DATE,D3.DAY_DATE) as DAY_DATE, 

coalesce(D2.0RDER_METHOD,D3.0RDER_METHOD) as ORDER_METHOD, Non " 
D3.REASON_DESCRIPTION as REASON_PESCRIPTION, < conformed 

D2.SALE_TOTAL as SALE_TOTAL, dimension 

D3 . RETU RN_QU ANTITY as RETU RN_QU ANTITY 



from 



(select 

Ti me_Di mension . DAY_DATE as DAY_DATE, 

Order_Method_Dimension.ORDER_METHOD_EN as ORDER_METHOD, 

Return_Reason_Dimension.REASON_DESCRIPTION REASON_DESCRIPTION, 



group by 

Ti me_Di mension . DAY_DATE, 

Order_Method_Dimension.ORDER_METHOD_EN, 

Return_Reason_Dimension.REASON_DESCRIPTION 

) D3 

full outer join 
(select 



Found only 
in query of 
related 
fact 



) D2 

on ((D2.DAY_DATE = D3.DAY_DATE) and (D2.0RDER_METH0D = D3.0RDER_METH0D)) 



Cognos 

software 
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Non-conformed dimensions will not use a coalesce function and only show up in the 
derived table of the fact to which they are related. 

If you are using what you expect to be a conformed dimension in a multi- fact query 
and no coalesce function is generated, you should investigate your model. Ensure no 
query path has been missed or that the IBM Cognos query engine is not identifying the 
dimension as a fact based on cardinality. 
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Business Analytics 



What is an RSUM(1 asc local) as sc? 



■ IBM Cognos is generating a stitch column that will be 
used to stitch queries together locally. 

■ found in multi-fact queries when automatic 
summarization is not enabled, when there is no 
common level of granularity, and when: 



■ at least one conformed dimension is present 



RSUM(1 for Order_Method_Dimension.ORDER_METHOD_KEY order by 
Order_Method_Dimension.ORDER_METHOD_KEY asc local) as scl 



■ no conformed dimensions are present 



RSUM(1 order by Sales_Target_Fact.SALES_TARGET asc local) as sc 



Coqnos. 

software 
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If automatic aggregation is not enabled and at least one conformed dimension is 
present, you will see the same stitch column generated in both derived tables of a stitch 
query. This stitch column takes a common key(s) from the conformed dimension(s) 
between the two queries and sorts it ascending locally on the IBM Cognos server. 
These columns and others then merge the two result sets. The fact values in the fact 
columns will be related to the conformed dimension but not necessarily to each other. 

If automatic aggregation is not enabled and there are no conformed dimensions 
present, IBM Cognos will attempt to generate a stitch column by selecting a column 
from each query and using it to create unique values that will merge the queries. There 
are no definite relationships between the facts. 

In either case RSUM(1 asc local) as sc is cause for investigation to ensure the correct 

results are returned. 
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Business Analytics =^=^1 

What is an RSUM(1 ...... asc local) as sc? 

(cont'd) 

■ The following syntax indicates that a conformed 
dimension has not been included in a multi-fact 

Query. Stitch columr^from Query 1 of stitch query 

RSUM(1 order by ORDER_DETAILS.ORDER_DETAIL_CODE asc local) as sc 



full outer join 



RSUM(1 order by PRODUCT_FORECAST.PRODUCT_NUMBER asc local) as sc 

\ 

Stitch column from Query 2 of stitch query 

Cogiios* 

on (Query l.sc = Query 2.sc) software 

©2010 IBM Corporation 



Each query uses a different column to generate the stitch column that in most cases, 
returns unrelated results. 
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Business Analytics 

Why Do I See XSUM? 

■ For readability, Cognos SQL uses windowed 
aggregates. 

■ Cognos SQL: 

■ XSUM(Sales_Fact.SALE_TOTAL for 
Time_Dimension.MONTH_KEY ) as SALE_TOTAL 

■ Native SQL: 

■ sum("Sales_Fact"."SALE_TOTAL") AS "SALE_TOTAL" 



Coanos 

software 
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XSUM in Cognos SQL indicates a windowed aggregate, in which you can see what 
value is being aggregated and to what level(s) . 

The X in XSUM stands for extended, which indicates that the overall total for each row 
of a particular grouping will be calculated and retrieved. 
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Demo 1 : Identify Stitch Queries in Generated SQL 



Purpose: 

When running multi-fact queries, you must identify the components 
of the generated SQL. Understanding the patterns of correctly 
generated stitch queries will let you effectively troubleshoot 
improperly constructed queries. To that end, you will test various 
multi-fact query scenarios and explore the generated SQL. 



Component: Framework Manager 

Project: GO Operational 

Task 1. Test fact queries individually. 

Before testing a multi- fact query, you will test each fact query to examine the 

1. In Framework Manager, close any projects that may be open, and then open 
the GO Operational project located at C:\Edcognos\B5152\ 
CBIFM-Start Files \Module 18\GO Operational. 

2. If prompted, log in as User ID admin, and Password Education!.!. 

3. In the Project Viewer, expand GO Operational Model> Consolidation 
View. 

4. Test the following items together: 



Query Subject 


Query Item 


Time 


Month 


Sales Fact 


Revenue 



The Test Results dialog appears. You will view the generated SQL before 
applying Auto Sum. 
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5. Click the Query Information tab. 

The results appear as follows: 

Cog nos SQL 

select 

T DIED DIEHS I OH . MOHTHEH as Mont hi , 

S ale s_F ac t . Rev enue as Rev enue 

from 

GOSALES . GOSALES . gosales . T IME_D DIEHS I OH T IME_D DIEHS I OH , 

( select 

ORDERHEADER . ORDER_DATE as ORDER_DATE , 

( ORDERDE TAILS . QUAHTITY * ORDERDE TAIL S . UHI TSALEPRI CE ) as Revenue 

from 

GOSALES . GOSALES . gosales . ORDER HEADER ORDER HEADER , 

GO SALES . GOSALES . gosales . ORDER_DE TAIL S ORDER_DE TAIL S 

where 

( ORDER HEADER . ORDERHUMBER = ORDER DE TAIL S . ORDERHUMBER ) 

) Sales_Fact 

where 

(TIMEDIMEHSIOH.DAYDATE = S ale s_F ac t . ORDER DATE ) 

You see a basic query where the TIM E _DIM E NSI ON dimension and Sales 
Fact query subjects are joined. A derived table is generated in the Cognos SQL 
for Sales Fact since the Revenue column you selected in the query is based on a 
calculation. Again, Cognos SQL is more verbose. The native SQL does not 
require a derived table for this basic calculation based on columns from the 
same table. 

Note: You see Monthl in the generated SQL as opposed to Month because 
month is a reserved word. Therefore, a 1 is appended to avoid any 
conflicts. 

6. Click the Test tab, select the Auto Sum check box, and then click Test 
Sample. 
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7. Click the Query Information tab. 
The results appear as follows: 




Now you see that XSUM has been applied in the Cognos SQL to aggregate 
Revenue to the month level. The sum function is used in the native SQL. 

8. Click Close. 

9. In the Project Viewer, test the following items together from the 

Consolidation View: 



Query Subject 


Query Item 


Time 


Month 


Sales Target Fact 


Sales T arget 
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10. Click the Query Information tab. 

The results appear as follows: 

Cog nos SQL 

select 

T IME_D MENS I OH .MOHTHEH as Monthl , 

SALE S TARGET. SALE S TARGET as Sales Tarcjet 

from 

( select 

TIMEDIMEHSIOH.CURREHTYEAR as ClIRREHTYEAR , 

T DIE D IMEHS I OH . CURREHTMOHTH as CURREHTMOHTH , 

XMIH( TDIEDIME HSIOH. MOH THEH fo r T DIED IMEH S I OH . C lIRREHTYEAR , T DIED IMEH S I OH . C Up| 

from 

GO SALE S . GO SAL ES ■ tj o s ales . T IME D IMEHS I OH TLMEDLMEHSIOH 

group by 

T IMED IMEHS I OH . ClIRREHT YEAR , 

TIME DIMEHSIOH. CURREHT MQHTH 

) TIMEDIMEHSIOH, 

GOSALES . GO SALES . go sales . SALE STAR GET SALE STAR GET 

where 

( ( T MED IMEHS I OH . ClIRREHTYEAR = SALE STAR GET . SALESYEAR) and ( TMEDMEHSIOH . CURREHTMD 

Because Sales Target rolls up to the month level and not the day level and you 
have specified determinants on the TIME_DEMENSION, an XMIN function 
and a group by clause is generated in the Cognos SQL. The XMIN function in 
the Cognos SQL (min in the native SQL) ensures that only one month value is 
returned for each month. The determinant for the month level specifies a multi- 
part key, which is why the derived table for TI ME _DIM E NSI ON uses a group 
by clause on CURRENT_YEAR and CURRENT JVtONTH. This prevents 
double-counting for Sales Target because the values are not aggregated for 
every day in the month, but rather at the grouped month level. 

Without the determinants, the generated SQL would not include the XMIN 
function or a grouping on the keys. You will test this in the next few steps. 

1 1 . Click Close, expand Foundation Objects View>gosales, and then double- 
click TIME_DIMENSION. 

12. Click the Determinants tab, delete all the determinants except for the Day 
determinant, and then click OK. 
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13. Test the following query items in the Consolidation View: 



Query Subject 


Query Item 


Time 


Month 


Sales Target Fact 


Sales T arget 



Remember, the items in the Consolidation View are based on items in the 
Foundation Objects View. You are testing the objects that authors will use. 



14. Click the Query Information tab. 

The results appear as follows: 

Cog nos SQL 

select 

T IMED IMENS I OH . MOHTHEH as Mont hi , 

SALE STARGET. SALE STARGET as SalesTarget 

from 

GOSALES . GOSALES . gosales . TIMEDIMEHSIOH TIMEDIMEHSIOH , 

GOSALES . GOSALES . gosales . SALES TARGET SALES TARGET 

where 

( ( TIMEDIMEHSIOH. CURREHTYEAR = SALE STARGE T . SALES YEAR) and (TIME 

Native SQL 

select " TIME DIMEHSIOH" . "MOHTH EH" AS "Monthl" , " SALES TARGET" . " SALESTA1 
11 GOSALES 11 . " gosales 11 . 11 TIME DIMEHSIOH" " TIME DIMEHSIOH" , " GOSALES " . " gosales 
" TIMEDIMEHSIOH" . " CURREHTYEAR" = " SALESTARGET" . " SALESYEAR" and "TIME! 
"SALES TARGET" . "SALES PERIOD" 



The XMIN function and group by clause is no longer present. Now, if you 
aggregated Sales Target, each value would be double-counted, once for every 
day in the month for which it is associated. 

You can verify the effect of double-counting by retesting with Auto Sum 
enabled. Take note of the totals and then compare them to the values seen in 
the following steps when determinants are returned. 

15. Click Close, and then from the Edit menu, click Undo Edit Definition. 
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16. Retest the same query items with Auto Sum enabled, and then click the Query 
Information tab. 

The results appear as shown below: 



Cog nos SQL 



select 



TIME DIMENS I ON. MONTH EN as Monthly 



from 



XSUM( SALES TARGET. SALES TARGET for TIME DIMENS I ON. MONTH EN ) as Sales Targ 



( select 

TIMEDIMENSION . CURRENTYEAR as CURRENTYEAR , 

T DIE D IMEHS I ON . CURREHTMONTH as CURREHTMONTH , 

XMIH ( T IMED IMEHS I OH . MOHTHEH for T HIED IMEHS I OH . CURRENTYEAR , T IMED HI 

from 

GO SALES . GO SALES . go sales . TIMEDIMENSION TIMEDIMENSION 
group by 

T IME D IMEHS I ON . CURRENT YEAR , 

TIME DIMENSION . CURREHT MONTH 
) TIMEDIMENSION, 

GO SALES . GO SALES . go sales . SALESTARGET SALESTARGET 

where 

( ( TIME DniEHSIOH. CURRENT YEAR = SALE S TARGE T . SALE S YEAR) and ( TIME DIMENSION. 
group by 

TIME DIMENSION. MONTH EN 



Native SQL 



select 11 TIME_DIMEHSION" . "MOHTH_EN" AS "Monthl" , sum( " SALES TARGET" . " SALES TARGET" ) A 
" T1ME_DIMEHSI0H" . 11 CURRENT_YEAR" AS 11 CURRENTYEAR" , "TIME _E EMERSION" . 11 CURREHT_MOHTH" , 
("TIME DIMENSION" . "MONTH EH") AS "MONTH EH" from " GO SALES" . " go sales" . " TIME DIMENSION 



Now you see that XSUM has been applied in the Cognos SQL to aggregate 
Sales Target to the month level. The sum function is used in the native SQL. 

Again, if you examine the sales target values, you will see they appear correctly 
now that determinants have been re-applied. 



1 7. Click Close. 
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Task 2. Test multi-fact/multi-grain query. 

Now that you have seen how the generated SQL appears for each of the fact 
queries individually, you will test them together. Not only is this test for multiple 
facts, it also illustrates multiple levels of granularity. Revenue rolls up to the day 
level and Sales Target rolls up to the month level. 

1 . In the Project Viewer, in the Consolidation View, test the following items 
together: 



Query Subject 


Query Item 


Time 


Month 


Sales Fact 


Revenue 


Sales Target Fact 


Sales T arget 



Due to the large data set, this query may take some time. 
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2. Click the Query Information tab. 

The results appear as follows: 

Cog nos SQL 

seXect 

coaXesce(D2 .Month2 ,D3 .Month2) as Monthly 

D2. Revenue as Revenue f 

D3 . SaXes_Target as SaXes_Target 

from 

( seXect 

TIMEDIMEHSIOH.DAYKEY as sc, 

T IMED IMEHS I OH . MOHTHEH as Month2 , 

SaXes Fact .Revenue as Revenue, 

1 for T HIED IMEHS I OH . DAYKE Y order by T HIED IMEHS I OH . DAYKE Y asc XocaX) 

from 

GOSALES . GOSALES . gosaXes . TIMEDIMEHSIOH TIMEDIMEHSIOH , 

( seXect 

ORDERHEADER . ORDERDATE as ORDERDATE , 

(ORDERDE TAILS. QUART I TY * ORDERDETAILS . UHITSALEPRICE > as Revenue 

from 

GOSALES . GOSALES . gosaXes . ORDERHEADER ORDERHEADER , 

GOSALES . GOSALES . gosaXes . ORDERDETAILS ORDERDETAILS 

where 

( ORDER HEADER . ORDER ITUMBER = ORDER DE TAILS . ORDER ITUMBER) 

) SaXes_Fact 

where 

(TIME DIMEHSIOH.DAY DATE = SaXes Fact . ORDER DATE ) 
order by 

sc asc 

) D2 

f ill 1 outer join 
( seXect 

TIMEDIMEHSIOH.DAYKEY as sc, 

T IMED IMEHS I OH . MOHTHEH as Month2 , 

SAL ES T ARGET .SAL ES T ARGET as S aXes Tar get, 
pRSUM(l for T KtE_T) IMEHS I OH . DAYKEY o r der bjTl' DIED IMEHS I OHTDAY^iS Y""asc XocaX) 

from 

GOSALES . GOSALES . gosaXes . TIME DIMEHSIOH TIME DIMEHSIOH , 

GOSALES . GOSALES . gosaXes . SALE STAR GET SALESTARGET 

where 

( (TIME DIMEHSIOH.CURREHT YEAR = SALE S TARGE T . SALE S YEAR) and ( TIME DIMEHSIOH . CU 
order by 

sc asc 

) D3 

on ((D2.sc = D3.sc) and (D2.sc4 = D3.sc4)) 
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The generated Cognos SQL presents a coalesce function, as expected, because 
Time is a conformed dimension between Sales Fact and Sales Target Fact. Auto 
Sum is not enabled, so there are two facts without a common level of 
granularity between them. Revenue rolls up to the day level and Sales Target 

rolls up to the month level. This is why we see the RSUM(1 asc local) as sc 

syntax in both derived tables, D2 and D3, which are joined together by a full 
outer join. The full outer join uses two stitch columns, sc, and sc4, to merge the 
two record sets together. 

The native SQL does not present a full outer join. It is actually two separate 
queries sent to the database, since we are asking for local processing in our 
RSUM functions. Therefore, the merging is done locally. The merged results for 
Revenue and Sales Target will be related to Month, but not necessarily to each 
other. 

3. Click the Test tab, select Auto Sum, and then click Test Sample. 
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4. Click the Query Information tab. 

The results appear as shown below: 

Cognos SQL 

select 

coalesce ( D2 .Monthl ,©3 .Monthl ) as Monthl , 

D2. Revenue as Revenue, 

R3 . Sales_Target as Sales_Target 

from 

( select 

T IME_D MENS I OH . MOHTH_EH as Monthl, 

XSUM( S ale s_F act .Revenue for TIIIERIMENSION.MOHTHEH ) as Revenue 

from 

GOSALES . GOSALES . gosales . TIMERIMENSION TIMERIMENSION , 

( select 

ORRERHEARER . ORRERRATE as ORRERRATE , 

(ORRERRE TAILS. QUANTITY * ORRERRE TAIL S . UNI TSALEPRICE > as Revenue 

from 

GOSALES . GOSALES . go sales . ORRERHEARER ORRERHEARER , 

GOSALES . GOSALES . gosales . ORRER_RE TAIL S ORRER_RE TAIL S 

where 

(ORRERHEARER.ORRERNUMBER = ORRERRE TAILS . ORRERNUMBER) 

) Sales_Fact 

where 

(TIMERIMENSION.RAYRATE = SalesFact . ORRERRATE ) 
group hy 

T IMER IMEHS I ON . MONTHEN 

) R2 

full outer join 
( select 

T IME R IMENS I ON . MONTH EN as Monthl , 

XSUM( SALE STARGET. SALE STARGET for T IMER IMEHS I OH . MONTHEN ) as SalesTarget 

from 

( select 

T IME_R IMENS I ON . CURREHT YEAR as CURREHT YEAR , 

TIME RIMENSION . CURRENT MONTH as CURRENT MONTH , 

XMIN ( T IMER IMEHS I OH . MONTHEN for T IMER IMEHS ION. CURREHTYEAR , T IMER UfEH: 

from 

GOSALES . GOSALES . gosales . TIMERIMENSION TIMERIMENSION 
group hy 

TIME RIMENSION. CURREHT YEAR, 

TIME RIMENSION. CURRENT MONTH 
) TIMERIMENSION, 

GOSALES . GOSALES . gosales . SALES TARGET SALES TARGET 

where 

( ( TUltERIllEHSION. CURREHTYEAR = SALE STARGE T . SALE SYEAR) and ( TIMER IMENS ION . CU1 
group by 

T IME R IMENS I ON . MONTH EN 

) R3 

on (R2 .Monthl = R3 .Monthl) 
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If you examine the D2 and D3 derived tables you will see that they represent 
the same generated SQL you saw when you tested the fact queries individually. 
However, now they are a part of a larger query that will merge them. There is 
also a common level of granularity between the queries since both are now 
aggregated to and grouped by the Month level. If you examine the native SQL 
we will see that rather than two separate queries, IBM Cognos is now sending a 
single query and requesting that the database process the full outer join. 

5. Click Close. 

Task 3. Identify improperly formed multi-fact queries. 

1 . In the Project Viewer, in the Consolidation View, test the following items 



together: 



Query Subject 


Query Item 


Order Method 


Order Method 


Sales Fact 


Revenue 


Sales Target Fact 


Sales T arget 



1 8-24 © 2003, 201 0, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 





ADVANCED GENERATED SQL CONCEPTS AND COMPLEX QUERIES 



2. Click the Query Information tab. 

The results appear as follows: 

Cog nos SQL 

select 

D2 . Order_Method as Order_Method, 

D2. Revenue as Revenue, 

D3 . Sales_Target as Sales_Target 

from 

( select 

ORDERME THOD . ORDERME THODEN as Orde r_Me t ho d , 

Sale s Fact .Revenue as Revenue, 

| RSUH (1 order toy ORDER METHOD .ORDER METHOD EH asc local) as sc| 

from 

GOSALES . GOSALES . gosales . ORDERMETHOD ORDERMETHOD , 

( select 

ORDERHEADER . ORDERME THODC ODE as ORDERME THODC ODE , 
(ORDERDE TAILS. QUANTITY * ORDERDE TAIL S . UNI TSALEPRICE ) as 

from 

GOSALES . GOSALES . gosales . ORDER HEADER ORDER HEADER , 

GOSALES . GOSALES . gosales . ORDER_DE TAIL S ORDER_DE TAIL S 

where 

( ORDER HEADER . ORDERNUMBER = ORDER DE TAIL S . ORDER NUMBER ) 

) Sales_Fact 

where 

( ORDERMETHOD . ORDERME THODC ODE = SalesFac t . ORDERMETHODCODE ) 
order by 

Order_Method asc 

) D2 

full outer join 
( select 

SAL E S TARGET . SALES TARGET as Sales Target , 

RSUM( 1 order by SALES_TARGET . SALES_TARGET asc local) as sc 

from 

GOSALES . GOSALES . gosales . SALE STAR GET SALE STAR GET 
order by 

Sales_Target asc 

) D3 

on (D2.sc = D3.sc) 

You can immediately tell that this query is suspect by the absence of the 
coalesce function. When you author multi-fact queries, you must include at least 
one conformed dimension. Other indicators are the generated stitch columns 
highlighted above. Each one uses a different column to generate a key that will 
merge the queries. 
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3. Click the Test tab, select Auto Sum, and then click Test Sample. 



The results appear as follows: 







Order Method 


Revenue 


Sales Target 




Sales visit 


310194834 


4205383540 




E-mail 


17984304416 


4205383540' 




Mail 


4800133897 


4205383540 


Special 


27351320.25 


4205383540' 




Telephone 


340335731.08 


4205383540' 




Fax 


70073542.01 


4205383540' 




Web 


3712235303.4 


4205383540' 



Sales Target repeats the overall total for each row. 
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4. Click the Query Information tab. 

The results appear as follows: 

Cognos SQL 

select 

D2 . Order_Method as Order_Method, 

D 2. Re venue as Revenue, 

D3 . Sales_Target as Sales_Target 

from 

( select 

ORDER ME THOD . ORDERME THODEH as 0 r de r_Me tho d , 

XSUM( Sale s_F act .Revenue for ORDER_METHOD . ORDER_METHOD_EH ) as Revenue 

from 

GO SALES . GOSALES . gosales . ORDER_ME THOD ORDERMETHOD , 

( select 

ORDERHEADER . ORDERME THODC ODE as ORDERME THODC ODE , 

(ORDER DE TAILS. QUANTITY * ORDERDE TAILS . UHITSALEPRICE ) as Revenue 

from 

GOSALES . GOSALES . gosales . ORDER HEADER ORDER HEADER, 

GOSALES . GOSALES . gosales . ORDERDE TAILS ORDERDE TAILS 

where 

( ORDER HEADER . ORDER HUMBER = ORDERDE TAILS . ORDERHUMBER) 

) SalesFact 

where 

( ORDERMETHOD . ORDERMETHODCODE = SalesFact . ORDERMETHODCODE ) 
group hy 

ORDERMETHOD . ORDERME THODEH 

) D2, 

(select distinct 

XSUM( SALE STARGET. SALE STARGET ) as SalesTarget 

from 

GOSALES . GOSALES . gosales . SALES TARGET SALES TARGET 

} D3 

Again, the query can still be identified as an improper attempt to query multiple 
facts. There is no coalesce function, and you are sending two separate queries, 
one for each fact. The first derived table, which queries the Revenue fact, 
appears to be correct. But the second derived table, which queries the Sales 
Target fact, is simply requesting a distinct overall total. This value will be 
repeated for each row returned by the first derived table. 

5. Click Close, and leave Framework Manager open. 

Results: 

By testing various fact and multi-fact queries, you identified traits 
and patterns in the generated SQL, which indicate correctly 
modeled query subjects. You also examined and identified patterns 
for improperly formed multi-fact queries. 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



18-27 




IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Workshop 1 : Reverse Engineer a Framework Manager Model 

from Generated Cognos SQL 



You have just been handed some generated SQL from a report author who is 
expressing concern regarding the SQL. This SQL uses explicit join syntax (INNER 
JOIN) rather than implicit join syntax (WHERE clauses). Review the SQL and try to 
reverse engineer the model based on the query subjects used to author the report. 
During this process, take note of some of the unexpected SQL and explain it. 

Write notes in the margin explaining the various portions of the SQL. Use the blank 
space provided to draw the report that this SQL created, and a free-hand diagram of 
the portion of the model representing the queries used in the report. Be sure to include 
the cardinalities in the diagram. 

select 

coalesce (D2 . M0NTH1 , D3 . M0NTH1 ) as M0NTH1 , 
coalesce (D2 . ORDER_METHOD, D3 . ORDER_METHOD) as 
ORDER_METHOD, 

D3 . REAS ON_DE SCRIPT I ON as REASON_DESCRIPTION, 

D2. QUANTITY as QUANTITY, 

D3. RETURN QUANTITY as RETURN QUANTITY 



from 



( select 

Time Dimension . M0NTH1 as M0NTH1, 

Order_Method Dimension . ORDER METHOD as 
ORDER_METHOD, _ 

Return_Reason_Dimension . REASON DESCRIPTION as 
REASON_DESCRI PTION, 

XSUM (Returned_Items_Fact . RETURN_QUANTITY for 
Time Dimension . M0NTH1 , Order_Method Dimension . ORDER M 
ETHOD, Return_Reason_Dimension . REASON DESCRIPTION ) 
as RE T U RN_Q U AN TIT Y _ _ 

from 
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(select 

Time Dimension . DAY KEY as DAY KEY, 

Time Dimension . MONTH EN as M0NTH1 
from 

go data warehouse . GOSLDW . dbo . TIME DIMENSION 
Time Dimension) Time Dimension 

j oin 

go_data_warehouse . GOSLDW . dbo . RETURNED_ITEMS_FACT 
Returned Items Fact 

on (Time Dimension . DAY KEY = 

Returned Items Fact . DAY KEY) 

j oin 

( select 

Order_Method Dimension . ORDER METHOD KEY 
as ORDER_METHOD_KEY, 

Order_Method Dimension . ORDER METHOD EN 

as _ ORDER METHOD 



from 

go_data_warehouse . GOSLDW . dbo . ORDER_METHOD_DIMENS ION 
Order_Method Dimension) Order_Method Dimension 

on (Order_Method Dimension . ORDER METHOD KEY = 
Returned Items Fact. ORDER METHOD KEY) 

j oin 

(select 

Return_Reason_Dimension . RETURN REASON KEY as 
RETURN~REASON~KEY, _ _ 

Return_Reason_Dimension . REASON DESCRIPTION EN 
as REASON DESCRIPTION 
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( V 1 0 . 1 ) 



from 

go_data_warehouse . GOSLDW . dbo . RETURN_REASON_DIMENS ION 
Return_Reason_Dimension) Return_Reason_Dimension 

on (Return_Reason_Dimension . RETURN REASON KEY 
= Returned_Items_Fact . RE T URN_RE AS ON_KE Y) 

group by 

Time Dimension . MONTH 1 , 

Order_Method Dimension . ORDER METHOD, 
Return_Reason_Dimension . REASON DESCRIPTION 

) D3 

full outer join 
(select 

Time Dimension . MONTH1 as MONTH1, 

Order_Method Dimension . ORDER METHOD as 
ORDER_METHOD, _ 

XSUM ( Sales_Fact . QUANTITY for 
Time Dimension . MONTH1 , Order_Method Dimension . ORDER M 
ETHOD ) as QUANTITY _ _ _ 

from 

(select 

Time Dimension . DAY KEY as DAY KEY, 

Time Dimension . MONTH EN as MONTH1 

from 

go data warehouse . GOSLDW . dbo . TIME DIMENSION 
Time Dimension) Time Dimension 

j oin 

go data warehouse . GOSLDW . dbo . SALES FACT 
Sales_Fact 

on (Time Dimension . DAY KEY = 

Sales _ Fact .ORDER DA^ KEY) 
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j oin 



( select 

Order_Method Dimension . ORDER METHOD KEY 
_ as _ ORDER_METHOD_KEY, _ 

Order_Method Dimension . ORDER METHOD EN 

as ORDER METHOD 



from 

go_data_warehouse . GOSLDW . dbo . ORDER_METHOD_DIMENS ION 
Order_Method Dimension) Order_Method Dimension 

on (Order_Method Dimension . ORDER METHOD KEY = 
Sales_Fact . ORDER_METHOD_KEY) _ _ 

group by 

Time Dimension . MONTH1 , 

Order_Method Dimension . ORDER METHOD 

) D2 

on ( ( D3 . MONTH1 = D2.MONTH1) and ( D3 . ORDER_METHOD = 
D2 .ORDER METHOD) ) 
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Workshop 1 : Solution 



High-Level Representation of the Overall Query 



Select from 




Full outer join 



on ( (D3 . StitchKeyl = D2 . StitchKeyl ) and 
(D3 . StitchKey2 = D2 . StitchKey2 ) ) 



Query 1 




Query 2 
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select 



from 



coalesce (D2 . M0NTH1 , D3 . MONTH1 ) as MONTH1, 
coalesce (D2 . ORDER_METHOD, D3 . ORDER_METHOD) as 
ORDER METHOD, 



D3. REASON DESCRIPTION as REASON DESCRIPTION; 



D2. QUANTITY as QUANTITY, 

D3. RETURN QUANTITY as RETURN QUANTITY 





Time Dimension . MOTT^ff^^^^^lHONTHl , 
Order_Method Dimension . ORDE! 

ORDER_METHOD, 

Return_Reason_Dimension . REASON DESCRIPTION 
REASON DESCRIPTION, 



as 



XSUM (Returned_Items_Fact . RETURN_QUANTITY for 
Time Dimension . MONTH1 , Order_Method Dimension . ORDER M 
ETHOD, Return_Reason_Dimension . REASON DESCRIPTION ) 
as RETURN QUANTITY^ 



N 



from 



( select 

Time Dimension . DAY KEY as DAY KEY, 
Time Dimension . MONTH EN as MONTH1 

from 

go data warehouse . GOSLDW . dbo . TIME DIMENSION 
Time Dimension) Time Dimension 



j oin 

go_data_warehouse . GOSLDW . dbo . RETURNED_ITEMS_FACT 
Returned Items Fact 

on (Time Dimension . DAY KEY = 

Returned Items Fact . DAY KEY) 

j oin 



( select 

Order_Method Dimension . ORDER METHOD KEY 
as ~ORDER_M~ETHOD_KEY, _ _ 

Order_Method Dimension . ORDER METHOD EN 
as ORDER METHOD 



from 

go_data_warehouse . GOSLDW . dbo . ORDER_METHOD_DIMENS ION 
Order Method Dimension) Order Method Dimension 



on (Order_Method Dimension . ORDER METHOD KEY = 
Returned Items Fact. ORDER METHOD KEY) 
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j oin 



( select 

Return_Reason_Dimension . RETURN REASON KEY as 
RETURN~REASON~KEY, _ ~ 

Return_Reason_Dimension . REASON DESCRIPTION EN 
as REASON_DESCRI PTION _ _ 

from 

go_data_warehouse . GOSLDW . dbo . RETURN_REASON_DIMENS ION 
Return Reason Dimension) Return Reason Dimension 



on (Return_Reason_Dimension . RETURN REASON KEY 
= Returned - Items Fact. RETURN REASON KEY) 



This derived table retrieves rows 
from the Return Reason Dimension 
and joins the values with facts from 
Returned Items Fact on the 
RETURN JREASON_KEY. The final 
roll up for RETURN.QUANTITY will 
also be based on this key as seen in 
the group by clause. However, 
Return Reason Dimension is not a 
conformed dimension and therefore, 
the same derived table will not be 
found in the second derived table of 
this stitch query and it will have no 
impact on the roll up for the 



group by 

Time Dimension . MONTH 1 , 

Order_Method Dimension . ORDER METHOD, 

Return Reason Dimension . REASON DESCRIPTION 




full outer join 





Time Dimension.Mnm^^as 
Order_Method Dimension. 
ORDER METHOD, 



MONTH1 , 
HOD 



XSUM ( Sales_Fact . QUANTITY for 
Time Dimension . MONTH1 , Order_Method Dimension . ORDER M 
ETHOD ) as QUANTITY 



from 



\ 



( select 

Time Dimension . DAY KEY as DAY KEY, 
Time Dimension . MONTH EN as MONTH1 

from 

go_data_warehouse . GOSLDW . dbo . TIME_DIMENSION 
Time Dimension) Time Dimension 

j oin 

go_data_warehouse . GOSLDW . dbo . SALES_FACT 
Sales Fact 



QUANTITY. 

The group by clause, in this case, 
determines how the 
RETURN_QUANTITY values will be 
summed. 

D3 is the alias name for the first 
derived table in this stitch query. 

The full outer join pertains to the 
coalesce function which merges the 
two queries together. 

This is the second query in the stitch 
query. Its projection list requests the 
conformed dimensions and the other 
fact, in this case, QUANTITY. 

The XSUM indicates that 
aggregation is occurring for specific 
groupings. 

This derived table retrieves rows 
from the Time Dimension which are 
then joined to values from Sales Fact 
on the DAY_KEY. The final roll up for 
the report will be done at the month 
level. The same derived table is also 
found in the first derived table of this 
stitch query because Time 
Dimension is a conformed 
dimension. 



on (Time Dimension . DAY KEY = 
Sales Fact. ORDER DAY KEY) 



j oin 
( select 
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Order_Method Dimension . ORDER METHOD KEY 
as ORDER_METHOD_KEY, 

Order_Method Dimension . ORDER METHOD EN 
as ORDER METHOD 



from 

go_data_warehouse . GOSLDW . dbo . ORDER_METHOD_DIMENS ION 
Order Method Dimension) Order Method Dimension 



This derived table retrieves rows 
from the Order Method Dimension 
which are then joined to values from 
Sales Fact on the 
ORDER_METHOD_KEY. The final 
roll up for the report will also be 
based on this key. The same derived 
table is found in the first derived 
table of this stitch query because 
Order Method Dimension is a 
conformed dimension. 



on (Order_Method Dimension . ORDER METHOD KEY = 
Sales Fact. ORDER METHOD KEY) 



group by 

Time Dimension . MONTH1 r 

Order Method Dimension . ORDER METHOD 




on ( ( D3 . MONTH1 = D2.MONTH1) and ( 
D2 .ORDER METHOD) ) 




The group by clause, in this case, 
determines how the QUANTITY 
values will be summed. Notice that 
REASON_DESCRIPTION is not 
found in this group by clause. That is 
because it is not a conformed 
dimension. 

D2 is the alias name for the second 
derived table in this stitch query. 

This portion indicates the join criteria 
between the two queries of the stitch 
query. In this case they are joined on 
columns from the conformed 
dimensions. 



Report Representation Based on Generated SQL 



MONTH 


ORDER_METHOD 


REASON_DESCRIPTION 


QUANTITY 


RETURN_QUANTITY 


MONTH 


ORDER METHOD 


REASON_DESCRIPTION 


QUANTITY 


RETURN_QUANT I T Y 


MONTH 


ORDER METHOD 


REASON_DESCRIPTION 


QUANTITY 


RETURN_QUANT I T Y 


MONTH 


ORDER METHOD 


REASON_DESCRIPTION 


QUANTITY 


RETURN_QUANT I T Y 
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Model Diagram Based on Query Subjects Used to Generate SQL 
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Business Analytics 

Examine Cognos SQL in Report Studio 

■ IBM Cognos, by default, summarizes the data. 



select 



TIME_DIMENSION.MONTH_EN as Monthl, 



XSUM(Sales_Fact.Revenue for TIME_DIMENSION.MONTH_EN ) as Revenue, 

XSUM(Sales_Fact.Revenue for TIME_DIMENSION.MONTH_EN ) as 
Total Revenue 



from 




where 



Automatic Summarization 



(TIME_DIMENSION.DAY_DATE = Sales_Fact.ORDER_DATE) 



group by 

TIME DIMENSION. MONTH EN 






Automatic Grouping 



Cognos* 

software 

©2010 IBM Corporation 



Monthl is automatically grouped to roll Revenue and Total Revenue up to each 
individual instance of a month. This is done at the tabular level of the query. Extra 
aggregation may be done at the report layout level if summary footers are involved. 

If Auto Group & Summarize is turned off in Report Studio, the XSUM does not 
appear at the tabular level, but will appear at the report level for any summaries in the 
report layout. 



© 2003, 2010, IBM Corporation 18-37 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



I B M 



COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Business Analytics 

Examine Cognos SQL in Report Studio 
(cont'd) 

■ Why do I see two XSUMs? 

select 

TIME_DIMENSION.MONTH_EN as Monthl, 

XSU M (Sa les_Fact. Reven ue for TIME_DIMENSION.MONTH_EN ) as Revenue, 

XSUM(XSUM(Sales_Fact.Revenue for TIME_DIMENSION.MONTH_EN ) at 
TIME_DIMENSION.MONTH_EN ) as Total_Revenue_ 

from 



where 

(TIME_DIMENSION.DAY_DATE 
group by 

TIME DIMENSION. MONTH EN 




Footer Summarization 

= Sales_Fact.ORDER_DATE) 



Cognos. 

software 

©2010 IBM Corporation 



When summary footers are created in the report, they are represented by another 
XSUM as seen in the slide example. Total_Revenue_ is aggregated at the tabular level 
(Auto Group & Summarize is turned on) as seen by the inner XSUM, and then 
summarized for a summary footer for a particular grouping in the report layout as seen 
by the outer XSUM. 

Typically, you will see a nested XSUM for footers because auto summarization is 
enabled in the report. If it were not enabled, there would be no nested XSUM. 

If rollup processing is done locally on the IBM Cognos servers, you will see RSUM 
instead of XSUM as seen below: 

RSUM(XSUM(Sales_Fact.SALE_TOTAL for Time_Dimension.MONTHl ) at 
Time_Dimension.MONTHl order by Time_Dimension.MONTHl asc local) 
as SALE TOTAL1 
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Business Analytics " 

Differentiate Extended vs. Running 
Aggregates 

■ Extended aggregate (XSUM, XAVG, XMIN) operations retrieve 
overall totals. 



■ Found in generated SQL for queries run in batch mode (PDF, 
CVS, XML and so on) 

XSUM(XSUM(Sales_Fact. Revenue for 
TIME_DIMENSION.MONTH_EN ) at 
TIME_DIMENSION.MONTH_EN ) as Total_Revenue_ 



Running aggregate (RSUM, RAVG, RMIN) operations 
calculate totals as they are needed. 

■ Found in generated SQL for queries run in interactive mode 
(HTML) 

RSUM(XSUM(Sales_Fact. Revenue for 

TIME_DIMENSION.MONTH_EN ) at cognos 

)ft 



TIME_DIMENSION.MONTH_EN ) as Total_Revenue_ 



sortware 

©2010 IBM Corporation 



If the Rollup Processing property in Framework Manager or Report Studio is set to 
default, IBM Cognos will generate the appropriate SQL based on the report output 
type. 

Depending on the selected setting, you can force extended aggregation for interactive 
reports. 

For Query Studio, the Framework Manager setting will be used. 
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Demo 2: Examine Generated SQL in Report Studio 



Purpose: 

As a modeler, you need to understand SQL patterns that may be 
generated in Report Studio to help troubleshoot problems 
encountered by authors, or to simply answer their questions. By 
testing the model in Report Studio and viewing the generated SQL 
for different aggregation scenarios, you can see these patterns and 
learn how to identify what a report is requesting. 



Components: Framework Manager, Report Studio 

Project: GO Operational 

Package: GO Operational (query) 

Task 1 . Author a simple report in Report Studio and view the 

generated SQL. 

You will first publish the GO Operational (query) package. 

1 . In the Project Viewer, expand Packages, and then publish the GO 

Operational (query) package. 

2. Launch IBM Cognos Connection, log on, and then launch Report Studio 
selecting the GO Operational (query) package. 

3. Click Create new, and then double-click List. 
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5 . 

6 . 



In the Insertable Objects pane, expand Sales (query), and then add the 
following items to the report: 



Query Subject 


Query Item 


Time 


Month 


Sales Fact 


Revenue 



To the left of the report, place the cursor over 
click Query 1. 



Query Explorer 



□n 



and then 



In the Properties pane, click the box beside Generated SQL, and then click 
the ellipsis. 

A warning message appears indicating that you will be viewing a tabular 
representation of the query. 

Viewing the generated SQL by this method lets you see the SQL specific to this 
query. Header and footer summaries are not reflected in this SQL because it is 
specific to the report. 
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7. Click OK, and then from the list, select IBM Cognos SQL. 
The results appear as follows: 




Because the Auto Group & Summarize property is set to Yes by default, you 
see an XSUM for Revenue. To see detailed rows of data, set this property to 
No, which tells IBM Cognos not to apply the sum function. 

8. Click Close. 
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Task 2. Create a footer and view the generated SQL. 




3 . 

4 . 




Place the cursor over Page Explorer - \ j and then click Page 1. 

In the report, click the Revenue column header, and then on the T oolbar 



menu, click the Aggregate 




button, and then click Total. 



The report appears as shown below: 



Month 


Reven ue 














Overall - Total 


<1 ota 1 ( Reven ue )> 



Return to the Query Explorer, and then click Query 1. 
In the Properties pane, view the Generated SQL. 
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5. Click OK, and then click IBM Cognos SQL. 



The results appear as follows: 



IBM Cognos SQL 






select: 

TIME_DIMENSIQN . MONTHJEN as Month 1, 

XSUM: Sales Fact .Revenue for TIME DIMENSION . MONTH EN ^ as Revenue. 



fro 



XSUM{Sales_=act. Revenue for TTPt_DIMBMSION , MONTH_EN ) as Total_Revenue_ 



n 



GOS ALES . . GOS ALES .TIME_DIMENSION TIME_DIMEN5ION, 

(select 

ORDER_HE ADER . ORDERED ATE as ORDER_DATE. 

(ORDER_DET AILS . QUANTITY * ORDER_DET AILS . UNn_S ALE_ D RICE) as Revenue 
from 



GOS ALES. .GOS ALES. ORDER JC ADER ORDER_HEADER. 

GOS ALES . . GOS ALES . ORDER_OET AILS ORDER JDET AILS 
where 

(ORDER_HEADER . ORDERJMUMBER = ORDER_DET AILS . ORDER _N UMBER) 
) Sales_Fact 
where 

:TlME_DIMENSION . D A Y_D ATE = Sales_Fadt. ORDER JD ATE) 
group by 

TIME DIMENSION . MONTH EH 



The SQL appears similar to the previous task except that the tabular SQL is 
requesting a second summed Revenue as Total Revenue. This does not mean 
that two identical requests for Revenue will be sent to the database at mn time. 
This just represents the data items that make up the query at the tabular level. 
The derived table only requests Revenue once. If you look at the native SQL, 
you will also see only one request is made for revenue aliased as Cl. 

6. Click Close, and then from the Tools menu, click Show Generated 
SQL/MDX. 

Viewing the generated SQL by this method allows you to see the complete SQL 
statement including footer summary requests. 
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7. From the list, select IBM Cognos SQL. 



The results appear as follows: 



|l6M Cognos SQL ^ | 


select 

TIME_DIMENSION . MONTH_EN as Month 1, 

XSUM(Sales_Fact. Re venue for TIME_DIMENSION.MONTH_EN } as 
Revenue, 




XSUM(XSUM(Sales Fact. Revenue for TIME DIMENSION. MONTH EN } at 
TIME_DIMENSION.MONTH_EN ) as “otol_Revenue_ 





from 

GOS ALES. .GOS ALES. TIME_DIMENSION TTME_DIMBMSION ir 
(select 



ORDER_HE ADER . QRDER_D ATE as ORDER_DATE. 

(ORD.ER_DETAILS . QUANTITY * ORDER JDET AILS . UNIT_5 ALE_PRICE) 
as Revenue 
from 

GOS ALES. , GOS ALES. ORDERJHE ADER ORDER_HEADER, 

GOS ALES. .GOS ALES. ORDER_DET AILS ORDER_DETAILS 
where 

(ORDER JHEADER . ORDER_NUMBER = 

ORDER_DET AILS . ORDERJ-JUMEER) 

) Sales_-act 
where 

(TIME JDIM ENSIGN . D A Y_D ATE = SaIes_Fact, ORDER_D ATE} 
group by 

TIME DIMENSION. MONTH EH 



The additional XSUM for the Revenue column populates the report footer. 

If you change the Rollup processing property to Local, you will see an RSUM 
instead of an XSUM. This is illustrated in the Optimize and Tune Framework 
Manager Models module. 

If you turn off Auto Group & Summarize, you will not see nested XSUMs, 
since you would then be aggregating detailed rows for the footer and not 
summarized values. You will test this in the next steps. 

8. Select Native SQL. 

You will notice that footer summary information is not requested indicating 
that the footer summary information will be processed locally on the IBM 
Cognos servers. 
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9. 



18-46 



This environment uses a DB2 data source. The request for the footer summary 
is processed locally because DB2 does not support SQL-OLAP. If the data 
source were an Oracle database, you would see SQL-OLAP syntax requesting 
the footer value as shown below: 

select 

"TO". "CO" "MONTH1", "T0"."C1" "Revenue", 

sum("T0"."Cl") over () ”Total_Revenue_” 

from 

( ) "Cl" 

from 



group by 



Click Close, in the Properties pane, click the box beside Auto Group & 
Summarize, and then in the list click No. 
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10. From the Tools menu, click Show Generated SQL/MDX, and then from the 
list, click IBM Cognos SQL. 

The results appear as follows: 



IBM Cognos SQL - 

select 

TIME JDIMENSION , MONTH _EN as Month 1., 

^ialpq_Fart.Rpvpni.ip aq Bp'.:pnup 

|xSUM[Sales_ = act. Revenue ) as Total_Revenue_| 
from 

GOSALES. . GOS ALES ,TIME_DIMENSION TIME_DIMENSION l 
(select 

ORDER JHEADER , ORDER_DATE as ORDER_D ATE , 

(ORDER _DET AILS . QUANTITY ORDER_DET AILS , UNn_S ALE_PRICE) 
as Revenue 
from 

GOSALES . . GOSALES . ORDER JiEADER ORDER_HEADER, 

GOSALES . .GOSALES . ORDER_DET AILS ORDER_DETAILS 
where 

(ORDER JHEADER . ORDER JJUMBER = 

ORDER_DET AILS . ORDER_NUMBER) 

} Sales_ = act 
where 

:TlME_DIMEHSION . D A Y_D ATE = Sales_Fact ORDERED ATE) 



Now the footer value, Total_Revenue_, is based on the aggregation of detailed 
rows rather than summarized values. If you look at the native SQL, you will see 
that Revenue is now being requested twice from the database. Once as detail 
rows aliased as Cl, and again as a summarized row using the sum function 
aliased as CO. This type of aggregation is supported by the database and is 
therefore conducted at the database level. 

1 1 . Click Close, and then close Report Studio without saving the report. 

12. Leave IBM Cognos Connection and Framework Manager open for the next 
demo. 



Results: 

By testing the model in Report Studio and viewing the generated 
SQL for different aggregation scenarios, you have seen patterns in 
the SQL that you can use to identify what a report is requesting. 
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Business Analytics 

Examine Generated SQL for Dimensionally 
Modeled Relational (DMR) Metadata 

■ Regular dimensions may return un-requested columns 
in Framework Manager 

■ Occurs when you test levels that have attributes 

■ Does not occur in the IBM Cognos studios 



Cognos. 

software 
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When testing regular dimensions in Framework Manager, you may see several columns 
requested in the generated SQL that you did not select. 

This occurs when you test levels that have attributes specified. 

This is not the case in the IBM Cognos studios. Only required items for OLAP-style 
querying are requested. 



1 8-48 © 2003, 201 0, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 



ADVANCED GENERATED SQL CONCEPTS AND COMPLEX QUERIES 



Demo 3: Examine Generated SQL for Dimensionally Modeled 

Relational Metadata 



Purpose: 

When testing DMR levels in either Framework Manager or one of the 
IBM Cognos studios, you, as a modeler, should be aware of the SQL 
generation behavior in either scenario so that you are confident in 
your modeling techniques. 



Components: Framework Manager, Report Studio 

Project: GO Operational 

Package: GO Operational (analysis) 

Task 1. Test a level in the Products regular dimension in 

Framework Manager. 

1 . In Framework Manager, in the Project Viewer, expand Dimensional View> 
Products > Products . 
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2. Test the Product level (below Product Type), and then click the Query 
Information tab. 



The results appear as follows: 



Cog nos SQL 



select 



from 



( (PRODUCT IIAllE LOOKUP .PRODUCT IIAHE | | H 1 - 1 ) || cast ( ProductType 

Product_Type Product .PRODUCT_ITUM!BER as Product_Hum!:jer , 

PRODUCTHAMELOOKUP.PRODUCTDESCRIPTION as ProductDescription , 
Product Type Product .PRODUCT IMAGE as Product Image , 



Pro due t_Typ e 
Pro due t_Typ e 
Pro due t_Typ e 
Pro due t_Typ e 

( select 



Product . IHTRODUC T I OH_DATE 
P r o due t . D I S C OHT IHUEDDATE 
Product .PRODUCTIOHCOST 
Product .GROSS MARGIN as 



as Introduction_Date , 
as Discontinued_Date f 
Production_Cost , 
Gross Margin 



The projection list is requesting columns other than the business key 
(PRODUCT_NUMBER) and member caption (PRODUCT_NAME + 
PRODU CT_NUMBER) . PRODU CT_NUMBER, 
DISCONTINUED_DATE, PRODUCTION_COST, and so on, are all 
attributes of the Product level and PRODUCT_DESCRIPTION is the 
member description. 



3. Click Close, and then double-click the Products regular dimension to open the 

Dimension Definition dialog. 
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4. In the Hierarchies pane, click the Product level. 



The results appear as follows: 




,;;, Add Hierarchy cm Add i eye ] X Defee dfe Clear AH 



[s? Unique Level 



Select a level in the hierarchy control to see the query items. 



Name 


Role 


Source 


Product Caption 


_memberCaption 


Products. Product Nan ... 


Product Number 


_businessKey 


Products.Codes.ProdL ... 


Product Description 


_memberD escription . . . 


Products. Product Des ... 


Product Image 


. « . 


Products. Product Imat ... 


Introduction Date 


■ . . 


Products. Introduction ... 


Discontinued Date 


. . . 


Products. Discontinuec ... 


Production Cost 


. . . 


Products. Production C ... 


Gross Margin 




Products. Gross Margir ... 



Here you can see the member description and other attributes that were 
returned when you tested the Product level. In Framework Manager, these 
columns are returned to show the contents of the level. These columns would 
not necessarily be returned in the studios unless requested. Only the member 
caption and business key are returned with the level's parent keys, which you 
will see in the next step. 



5. Click Cancel, and then publish the GO Operational (analysis) package. 
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Task 2. Test a level in the Products regular dimension in 

Framework Manager. 

1 . In IBM Cognos Connection, launch Report Studio selecting the GO 
Operational (analysis) package. 

2. Create a new List report. 

3. In the Insertable Objects pane, expand Sales (analysis)> 
Products>Products, and then drag the Product level onto the report. 

4. From the Tools menu, click Show Generated SQL/MDX. 
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5. From the list, click IBM Cognos SQL. 



The results appear as shown below: 



IBM Cognos SQL 






select 



PRODUCT_LINE PRQCUCT_LINE_CODE as memberUniqueName2, 
XMIN{({PRODUCT_NAME__OOKUP . 3 R0DUCT_NAME |( N' -") || cast 

JProduct_Type ProductF'RODUCT_NUMBER as varchar (G))) for 

Product_Type ProduK±PRODUCT_NUMBER ) as Product, 

Product_Type Product. PRODUCT_TYPE_CODE as 

PRODUCT JWECODE, 

Product_ - ype Product. PRODUCTJMUMBER as PRODUCTJ-JUMEER . 

XMIN{PRODUCT_LINE , PRODUCT_UNE_EN for 

PRODUCT__INE . PRODUCT__IHE_CODE . ProductType Product. PRODUCT 

TYPE_CODE,ProdLKjt_Type Product. PRODUCT_NUMBER ) as re, 

XMIN{Product_Type Product . PRODUCT_TYPE_EN for 

ProductJType .Product PRODUCT_T¥PE_CODE ) as rc6 



from 



GOS ALES . . GOS ALES . PRODUCT__INE PRODUCT__INE, 
(select 

PRODUCT NAME LOOKUP. PRODUCT NUMBER as 



v = 



The projection list only requests the member caption (PRODI JCT_NAM E + 
PRODUCT_NUMBER), the business key (PRODUCT_NUMBER) , and 
parent business key and member caption columns. The parent information is 
returned to support drill operations such as drill up and down as well as drill- 
through. 



6. Click Close, and then close all browser windows without saving. 

7. Close the project without saving, and then close Framework Manager. 

Results: 

By examining the SQL generation for DMR levels in both Framework 
Manager and Report Studio, you can see that extraneous columns 
will not be returned in the studios unless authors request them. 

Only columns required to support OLAP-style querying will be 
returned 
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Business Analytics 

Define a Cross-Product Join 



A cross-product join combines data by matching each 
row in one table to each row in another table. 

A cross-product join is not the same as a full outer 
join. 



Manager 



Philippe 



Beatrice 



Report Set 



Sales Rep 


Product 


Philippe 


1 


Philippe 


2 


Philippe 


3 


Beatrice 


1 


Beatrice 


2 


Beatrice 


3 



Product 



1 
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This slide is a review of the concept of cross-product joins, which you saw earlier in the 
course. 

Cross-product joins are also known as a Cartesian product. 

A cross-product join occurs when there is no relationship between two query subjects. 

The results and aggregation totals for these types of queries are typically meaningless. 

By default, Framework Manager does not allow cross joins because they can be 
resource intensive. 
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Business Analytics ^== 

Identify Cross-Product Join SQL 

■ Cross-product join SQL simply selects the requested 
columns from their respective tables. 

■ No joins are implemented because they do not exist. 

select 

Manager.Manager as Manager, 

Product. Product as Product 

from 

datasource_name.database_name.schema. Manager Manager 
datasource name.database name.schema. Product Product 
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Business Analytics 



Identify Multi-Fact Query Results 



■ A contiguous result set uses only conformed dimensions. 



MONTH 


PRODUCT_NAME 


QUANTITY 


EXPECTED_VOLUME 


April 2004 


Aloe Relief 


1,410 


1,690 


April 2004 


Bear Edge 


574 


529 


April 2004 


Bear Survival Edge 


758 


954 



In a correlated list, non-conformed dimensions are present. 

Repeating 
values 



MONTH 


PRODUCT_NAME 


pRDER_MEtHOD) 


QUANTITY 


EXPECTED_V(XUMEv^ 


April 2004 


Aloe Relief 


Telephone 


286 


( 1,690 


April 2004 


Aloe Relief 


Web 


854 


\J.,690/ 


April 2004 


Aloe Relief 


E-mail 


270 


1,690 


April 2004 


Bear Edge 


Telephone 


224 


529 


April 2004 


Bear Edge 


Web 


60 


529 
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Interpreting a multi- fact query is not as easy as authoring one. It is important to 
understand the impact of conformed and non-conformed dimensions on a multi-fact 
query, and the level of granularity and additive nature of the data. 

A contiguous result set means the results of each fact query can be mapped to each 
other with 0..1 to 1..0 precision. 

A correlated list refers to a looser coupling of the data in which non-conformed 
dimensions have been introduced. 
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Business Analytics 

Identify Contiguous Result S< 

■ Multi-fact queries with only conformed dir 
can have different levels of granularity. 

Common Grain from Conformed Dimensions 


2tS 

mensions 

Repeating 




MONTH 


PRODUCT_NAME 


QUANTITY 


EXPECTED_VOLUME 




April 2004 


Aloe Relief 


1,410 


1,690 




April 2004 


Bear Edge 


574 


529 




April 2004 


Bear Survival Edge 


758 


954 




values 

Different Levels of Granularity from Conformed Dimension f 




C^MONTH 


day_datT> 


PRODUCT_NAME 


QUANTITY 


EXPECTEDVOLUIfE 


Coanos. 

software 


April 2004 


Apr 25, 2004 


Aloe Relief 


286 


/1,690 > 


April 2004 


Apr 27, 2004 


Aloe Relief 


854 


( 1,690 


April 2004 


Apr 28, 2004 


Aloe Relief 


270 


\l,690 > 


April 2004 


Apr 2, 2004 


Bear Edge 


224 


529 


April 2004 


Apr 4, 2004 


Bear Edge 


60 


529 


April 2004 


Apr 7, 2004 


Bear Edge 


166 


954 
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Business Analytics 

Identify Contiguous Result Sets 
(cont'd) 

■ Adding a lower level than the common level of 
granularity between the two facts, presents repeating 
values for the fact at the higher level. 



■ Determinants will prevent double-counting. 

Multi-Fact/ Multi-Grain Report 



MONTH 


DAY_DATE 


PRODUCTJNAME 


QUANTITY 


EXPECTED_VOLUME 


April 2004 


Apr 25, 2004 


Aloe Relief 


286 


1,690 


April 2004 


Apr 27, 2004 


Aloe Relief 


854 


1,690 


April 2004 


Apr 28, 2004 


Aloe Relief 


270 


1,690 


April 2004 


Apr 2, 2004 


Bear Edge 


224 


529 


April 2004 


Apr 4, 2004 


Bear Edge 


60 


529 


April 2004 


Apr 7, 2004 


Bear Edge 


166 


954 


Summary 


2,215,354 


2,166,005 
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With determinants specified, IBM Cognos will not double-count the values at the 
higher level of granularity. 

As seen in the slide example, EXPECTED_VOLUME is not double counted because 
the determinants specified on the Time Dimension dictate that those values should be 
aggregated to, and grouped by, the month key. 
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Business Analytics 

Troubleshoot Unexpected Results 

■ When the data results are unexpected, check the SQL. 

■ What kind of joins do you see? 

■ Do they correspond with the relationships you have in Framework 
Manager? 

■ Do you see a stitch query that you do not expect? 

■ Do you see a stitch query without all required conformed 
dimensions? 

■ Do you see a stitch query with no conformed dimensions? 

■ Do you have determinants specified for multiple levels of 
granularity in a single query subject? 

■ Are you using the correct SQL options? 

■ Check the native SQL to see if it is what you expected. 

Cognos„ 

software 
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Business Analytics =^==E"§: 

Summary 

■ You should now be able to identify: 

■ governors that affect SQL generation 

■ stitch query SQL 

■ conformed and non-conformed dimensions in 
generated SQL 

■ multi-fact/multi-grain stitch query SQL 

■ variances in Report Studio generated SQL 

■ dimensionally modeled relational SQL generation 

■ cross join SQL 

■ various results sets for multi-fact queries 

Coanos. 

software 
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Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ identify session and model parameters 

■ leverage session, model, and custom parameters 

■ create prompt macros 

■ leverage macro functions associated with security 
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Business Analytics 

IBM Cognos Session Parameters 

■ A variable associated with a IBM Cognos session 

■ There are two types of session parameters: 



■ environment 

■ model 



Parameter Value 


Override Value 


Hi account .default Name .Admin Person 




O account .personal Info .ema i admin @grtd 1 23 .com 




O account .personal \rio .given Name Admin 




Hi account .personal Inffo .surname Person 




O account .personal Into .userName admin 




O current _timestamp 2008- 1 0-flS 1 1 :G4 




H machine TF-KAMALA 




OrurtLocale an 





software 
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Each session parameter must have a name and a default value to ensure the session 
parameter resolves to a value at mn time. 

You cannot have more than one session parameter with the same name. 

Override values can be set for testing inside the model only. 
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Business Analytics 

Review Environment Session 
Parameters 

■ Predefined and stored in the content store database 




Coanos. 

software 
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This topic was briefly discussed in the Calculations and Filters module. Here are some 
more details. 

Depending on the authentication provider, you may see more or fewer session 
parameters. 

By default, the following session parameters appear in Framework Manager: 

• accountdefaultName 

• accountpersonallnfo.userName 

• runLocale 

If you log on anonymously, you will see only runLocale and 
account.defaultName(Anonymous) . 
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Business Analytics 

Leverage Environment Session 
Parameters 

Filter Expression 



[ Sales Target Fact] .[Sales Staff Code] = 

4$SecurityLookupfl$account.defaultName}# 

I 



i 



Session Parameter 



Parameter Map 



Key 


Value 


Bart Scott 


60 


Ana Orozco 


80 


Alex 

Rodriguez 


53 



I 



Generated SQL \ 



Where 

Sales_Target_Fact.Sales_Staff_Code = 60 
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As seen earlier in the course, use environment session parameters to create a dynamic 
model by using them in filters, SQL, property settings, and other model objects. 
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Business Analytics 



Model Session Parameters 

■ Created in Framework Manager and published with 
every package 

■ Can include the use of existing environment session 
parameters and static values 



Model 

Session Parameter 




Model session parameters can be useful when you are trying to centralize the 
maintenance on a macro that is used throughout a model. 
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Business Analytics 

Filter Data Based on Package Access 

■ Create model session parameters with static values 

■ Values are published with the package 

Static Value Representing 




rqosalesl.rSALES_TARGETUCOUNTRY_CODE_RE 


TAILER] = 


#$PackageCountryFilter# 





T 
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software 

©2010 IBM Corporation 



By using a model session parameter, you can centrally control a value throughout your 
model. In this case the value is static and controls which country for which a user can 
see values. 

The filter expression in the slide example generates a Where clause in which Country 
code equates to 6001 , which is the value specified in the model session parameter. 
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Demo 1 : Leverage Model Session Parameters 



Purpose: 

You have been asked to centralize the language lookup macro to 
save time when modeling future imports of new tables or data 
sources. You will do this by placing the macro in a model session 
parameter and using it throughout the model. 

You have also been asked to let report authors automatically filter 
data based on which package they choose. They would like to filter 
data based on countries. You will use a model session parameter 
and a model filter to fulfill this request. 



Components: Framework Manager, Business Insight Advanced 

Project: GO Operational 

Packages: GO Operational (query) - US, GO Operational (query) - France 

Task 1 . Centralize the language lookup macro. 

1. In Framework Manager, close any projects that may be open, and then open 

the GO Operational project located at C:\Edcognos\B5152\CBIFM-Start 
Files\Module 19\GO Operational. 

2. If prompted, log in as User ID admin, and Password Educationl!. 

3. From the Project menu, click Session Parameters. 

4. Click New Key, and then in the highlighted Parameter field, type 

U serLanguage. 
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5. In the Value field, type #$Language_lookup{$runLocale}# 



The results appear as follows: 





Parameter 


Value 


Override Value 


Hi account. defaultName 


Admin Person 




O account, personallnfo. email 


admin@grtd1 23.com 




O account, personall nf o. gi venN ame 


Admin 




01 account, personallnfo. surname 


Person 




Qj account, personall nf o. userN ame 


admin 




Qj currentjimestamp 


2008-10-2216:08:53.671-05:00 




P machine 


CLASS BASER 




Qj runLocale 


en 




BjjUserLanguaqe 


tt$Language_lookup{$runLocale}tt 





Note: For NT T J M, if an email address is not specified in the user's personal 

information in IBM Cognos Connection, you will not see an email entry 
in the session parameters. 

6. Click OK 

7. In the Project Viewer, expand GO Operational Model> 

Consolidation View> Order Method, and then double-click Order Method. 
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USE ADVANCED PARAMETERIZATION TECHNIQUES IN 



FRAMEWORK 



MANAGER 



8. Under Available Components, click the Parameters tab, and then expand 
Session Parameters. 



The results appear as follows: 



- m 







Parameter Maps 
Session Parameters 

account .default Name 
account .personal Info .email 
account .personal Info .given Name 
account .personal Info .surname 
account .personal Info .userName 
cumentjimestamp 
machine 
m_ run Locale 







m UserLanguage 



Macro Functions 



Notice the UserLanguage parameter. This is the new model session parameter 
you just created. 

9. In the expression, replace $Language_lookup{$runLocale} with the 
UserLanguage parameter. 



The results appear as follows: 

#' [gosales] . [ORDER_METHOD] . [ORDER JVtETHOD_'+ 
$U serLanguage + ']'# 




Click the Test Sample button 
click OK 



to ensure the macro works, and then 
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1 1 . Apply the same technique to Product Line and Product Type in the 
Products query subject. 



The results for each expression appear as follows: 



#' [gosales] . [PRODU CTJLINE] . [PRODU CT_LINE_'+ SUserLanguage +']’# 



#'[gosales]. [Product Type & Product]. [PRODUCT_TYPE_' + 

SUserLanguage + ’]'# 

If time permits, you can implement this technique for all language-based 
calculations in the project. 

12. Save the project as C:\Edcognos\B5152\Course_Project\Params\GO 
Operational, cpf. 

Task 2. Create a model session parameter to filter packages. 

1 . From the Project menu, click Session Parameters. 

2. Click New Key, and then in the highlighted Parameter field, type 

PackageCountryFilter. 

3. In the Value field, type 1003. 

This value represents the country code for the United States. 

The Session Parameters dialog box appears as shown below: 



Parameter | 


Value 


Override Value 


Hi account. defaultName 


Admin Person 




(0 account, personall nfo. email 


admin@grtd123.com 




account, personall nf o. gi venN ame 


Admin 




account, personall nf o. surname 


Person 




Hi account, personall nf o. userN ame 


admin 




Hi current_timestamp 


2008-10-2216:23:54.062-05:00 




Hi machine 


CLASS BASER 




Hi runLocale 


en 




SjjlJserLanquaqe 


tt$Language_lookup{$runl_ocale}tt 




■ PackageCountryFilter 


1003 





4. Click OK 
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Task 3. Apply a country filter using a model session 

parameter. 

1 . In the Project Viewer, in the Consolidation View namespace, double-click 
Sales Target Fact. 

2. Click the Filters tab, then click Add. 

3. In the Name box, type Country Filter. 

4. From Foundation Objects View>gosales>SALES_TARGET, add 

COUNTRY_CODE_RETAILER to the expression, followed by =. 

5. Under Available Components, click the Parameters tab, and then expand 
Session Parameters. 

6. Double-click PackageCountryFilter to add it to the expression definition. 

The results appear as follows: 

[gosales] . [SALES_TARGET] . [COUNTRY_CODE_RETAILER] = 

# $ Pack age C o un try Filter# 

Of course, you would apply similar filters on all fact query subjects published in 
the packages to ensure the model is truly region specific. For the purposes of 
this demonstration, you will apply the filter to only one fact query subject. 

7. Click OK, and then click OK again. 
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8. Test the following items in the Consolidation View with Auto Sum enabled: 



Query Subject 


Query Item 


Sales Target by Location 


Sales T arget Country 


Sales Target Fact 


Sales T arget 



The results appear as follows: 



Test results 




Sales Target Country 


Sales Target 




United States 


7423sa?aa 



Only a value for the United States is returned. 

9. Click Close, and then save the project. 

Task 4. Create and publish a filter-based package. 

You will create a package that will be filtered on the country of the Unites 
States. 

1. In the Project Viewer, expand Packages, copy GO Operational (query), 
paste the copy under Packages, and then rename the copy to GO 

Operational (query) - US. 

2. Publish the GO Operational (query) - US package. 

This package has now been published with a hard-coded model session 
parameter of 1003, which is the country code for the United States. 
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Task 5. Create and publish a second filter-based package. 

You will now create a second package that will be filtered on the country of 
France. 

1. Create another copy of GO Operational (query), and then rename it to GO 

Operational (query) - France. 

Before you can publish this package, you must change the 
PackageCountryFilter model session parameter value to represent the country 
code for France. 

2. From the Project menu, click Session Parameters, change the value for 

PackageCountryFilter from 1003 to 6001, and then click OK. 

3. Publish the GO Operational (query) - France package. 

When you publish filter-based packages, make sure you have the correct model 
session parameter value set. For example, before publishing GO Operational 
(query) - France, set the PackageCountryFilter value to 6001. Change it back to 
1003 before publishing GO Operational (query) - US. 

4. Save your project. 
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Task 6. Test filter-based packages in Business Insight 

Advanced. 

1 . Launch IBM Cognos Connection, log on, and then launch Business Insight 
Advanced selecting the GO Operational (query) - France package for a List 

report. 

2. Expand Sales Targets (query), and then add the following items to the report: 



Query Subject 


Query Item 


Sales Target by Location 


Sales T arget Country 


Sales Target Fact 


Sales T arget 



Only data for France appears. 



Sales Target Country 


Sales arget 


France 


257.675,400 


Overall - Summary 


257,675,400 



3. Return to IBM Cognos Connection, and do not save the report. 

4. Launch Business Insight Advanced again selecting the GO Operational 
(query) - US package. 

5. Create the same report. 

This time only data for the United States appears. 



Sales Target Country 


Sales arget 


Unted States 


742.360,700 


Overall - Summary 


742,360,700 



6. Return to IBM Cognos Connection, and do not save the report, and leave 
Framework Manager open for the next demo. 

Results: 

You centralized a widely used macro and created filter-based 
packages that let report authors automatically filter data based on 
the package they selected. 
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Business Analytics ^===^ 

Custom Environment Session 
Parameters 

■ Requires a customizable LDAP security provider 

■ Are exposed to IBM Cognos through IBM Cognos 
Configuration 

■ Appear as session parameters in Framework Manager 

Custom 
Session 
Parameter 



Cognos. 

software 

©2010 IBM Corporation 



Parameter 


Value 


Override Value 


dTI account .default Name 


Frank Bretton 




account .parameters . Location 


Calgary 




jlij. account .personal Info .business Phone 


1 (433) 232-5986 




account .personal Info .email 


FBretton@grtd123.com 




account .personal Info .fax Phone 


1 (433J 232-533 1 




dTI account .personal Info .given Name 


Frank 




account .personal Info .surname 


Bretton 




account .personal Info .userName 


brettonf 




-■ "■] n nat timpgtamn 


3d.na--m.-R ig-jq-?? 





Microsoft Active Directory and Sun Java System Server are both supported with 
respect to custom environment session parameters. 

Attributes available from an LD AP security provider can be exposed to IBM Cognos 
as custom properties through IBM Cognos Configuration. 
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Demo 2: Leverage Custom Environment Session Parameters 



Purpose: 

Report authors have requested the ability to filter their reports 
based on their location. To fulfill this request, you will leverage a 
custom property in The Great Outdoors Company LDAP 
authentication provider. You will make the custom property 
available as a session parameter in Framework Manager and then 
use that parameter in a model filter. 



Components: 



Project: 

Package: 



IBM Cognos Configuration, Framework Manager, Business 
Insight Advanced 

Go Operational 

GO Operational (query) 



Task 1. Configure IBM Cognos to use a custom session 

parameter. 



1 . 

2 . 

3 . 

4 . 



From the Start menu, point to All Programs > IBM Cognos 10, and then click 

IBM Cognos Configuration. 

In the Explorer pane, under Security > Authentication, click LDAP. 

In the Properties pane, scroll down to the Custom properties row, click 



inside the Value column, and then click Edit 



& 



In the Value dialog box, click Add, in the Name field, type Location, and 
then in the Value field, type 1 (lower case L). 

This value is associated with the custom parameter for locality in the LD AP 
authentication provider. 
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5. 




Click OK, save the configuration, and then click Restart 
IBM Cognos service. 




to restart 




Note: If you receive a warning message about the mail server connection, 
disregard it. A mail server is not used in this course. 



Close IBM Cognos Configuration. 



Task 2. View the custom session parameter in Framework 

Manager. 

1 . In Framework Manager, from the Project menu, click Logoff. 

2. Click Log on again, and then log on as brettonf (password=Educationl!) 
Frank Bretton is a report author that works out of the Calgary office. 

3. From the Project menu, click Session Parameters. 

The results appear as follows: 



Parameter 


Value 


Override Value 


■jHfl account .default Name 


Frank Bretton 




account .parameters . Location 


Calgary | 




jol account .personal Info .business Phone 


1 (403) 232-5336 




(0 account .personal Info .email 


F Bretton @artd 1 23 .com 




account .personal Info .fax Phone 


1 {403} 232-533 1 




O account .personal Info .given Name 


Frank 




(O account .personal Info .surname 


Bretton 




^ account .personal Inf o .userName 


brettonf 




impn! hmpdam 







For the logged on user, there is an accountparameters .Location parameter 
available with a value of Calgary, the city where this employee works. 

4. Click Cancel. 
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Task 3. Create a model filter that uses the custom parameter. 

1 . In the Project Viewer, under Presentation View, right-click the GO 
Operational Sales (query) namespace, point to Create, and then click Filter. 

2. In the Name box, type My Location. 

3. In the Available Components pane, expand Consolidation View> 

Staff by Location. 

4. Create the following expression: 

[Consolidation View] . [Staff by Location] . [Staff City] = 

5. Under Available Components, click the Parameters tab, expand Macro 
Functions, and then double-click sq to add it to the expression definition. 

Tip: You can view syntax assistance for macro functions by selecting them and 
viewing the Tips pane. There you can see explanations of the functions as 
well as examples. 

6. Expand Session Parameters, and then double-click 
account.parameters.Location to add it to the expression definition. 

The expression appears as shown below: 

[Consolidation View] . [Staff by Location] . [Staff City] = 

# sq($account.parameters. Location) # 

This filter uses the custom environment session parameter called Location to 
focus a query. 

7. Click OK, and then save the project. 
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Task 4. Test model filter in Business Insight Advanced. 

1 . In the Project Viewer, under Packages, double-click GO Operational 
(query), and then select My Location to add it to the package. 

The results appear as follows: 





i- x - H c 

EH X b q 
Ell X 
+ 

+ 

+ 


30 Op* 
g Pne 

- 

/ T 
/ T 
j/Jll 

T l 

' s H 


5 rational Model 
sentation View 
GO Operational Sales (query) 
|§| Sales (query) 

|§| Returns (query) 

H Sales Targets (query) 
Retailer Location filters 
r^fly Location 



2. Click OK, and then publish the GO Operational (query) package. 

3. In IBM Cognos Connection, log on as brettonf (password = Educationl!) . 

4. Launch Business Insight Advanced selecting the GO Operational (query) 

package for a List report. 

5. In the Insertable Objects pane, expand Sales (query), and then add the 



following items to the report: 



Query Subject 


Query Item 


Staff by Location 


Staff City 


Sales Fact 


Revenue 



All cities and their revenue appear. 



© 2003, 2010, IBM Corporation 19-21 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 




IBM COGNOS FRAMEWORK MANAGER: DESIGN 



METADATA MODELS (V10.1) 



6. From the Insertable Objects pane, drag the My Location filter to the report. 

7. Click OK 



The results appear as follows: 



Staff City 


Revenue 


Calgary 


51 11 .146,739.19 


Overall - Summary 


5111,146,739.19 



Because you are logged in as Frank Bretton, the report is filtered on his city, 
Calgary, using the custom environment session parameter. 

8. Return to IBM Cognos Connection without saving the report. 

Results: 

By leveraging a custom property in The Great Outdoors Company 
LDAP authentication provider, you let report authors filter their 
reports based on their location. 
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Business Analytics 


5 = == 


Examine the Scope of Session 




Parameters 




■ Session parameters can be used in: 




■ object properties 




-SQL 




■ filters and calculations 




■ stored procedure arguments 




■ model session parameter value 






Cognos 

software 

©2010 IBM Corporation 



Session parameters can be used in macros to dynamically change many model elements, 
including: 

• object properties such as Content manager datasource, Catalog, and Schema 
properties in data source connections 

• SQL in a data source query subject 

• filter and calculation syntax 

• and so on 
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Demo 3: Dynamically Change Your Data Source Connection 



Purpose: 

The Great Outdoors Company has different databases with the same 
structure but different data to serve different regions of the 
business. You will allow dynamic selection of a database based on 
the current user by using a macro and session parameter to change 
the Content Manager Datasource connection name at run time. 



Components: Framework Manager, IBM Cognos Connection 

Project: GO Operational 

Task 1 . Create a data source lookup parameter map. 

1. In Framework Manager, in the GO Operational project, right-click 
Parameter Maps, point to Create and then click Parameter Map. 

2. In the Name box, type DataSourceLookup, and then click Next. 

3. Under Key, in the first row, type brettonf and then under Value type 
GOSALES. 

4. Under Key, in the second row, type scottb, and then under Value, type 
GOSALES2. 

The results appear as follows: 




This parameter map will map the $account.personalInfo.userName value to the 
appropriate data source. 

5. Set Default value to GOSALES, and then click Finish. 
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Task 2. Create a second data source connection in IBM 

Cognos Connection. 

You will now create a second data source connection to the GO S ALE S database to 
mimic the ability to dynamically switch from one database to another depending on 
the current user. 

1. Log on to IBM Cognos Connection as admin (password = Educationl!) . 

2. Click Administer IBM Cognos content, and then click the Configuration 

tab. 

3. Create a new data source using the following parameters: 

• Name: GOSALES2 

• Type: IBM DB2 

• Database name: GS_DB 

• Select Password 

• User ID: GOSALES 

• Password: Educationl! 

• Confirm Password: Educationl! 

4. Click Finish. 

Task 3. Add a macro to the data source properties. 

1 . In Framework Manager, select the GOSALES data source. 

2. In the Properties pane, click in the Content Manager Datasource field, and 
then click the ellipsis. 

3. Delete the GOSALES text, and then click the Insert Macro button. 

4. Under Available components, expand Parameter Maps, and then double- 
click DataSourceLookup to add it to the definition. 
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Expand Session Parameters, and then drag 
account.personallnfo.userName into the brackets of the 
DataSourceLookup parameter map. 



The results appear as follows: 



#$DataSourceLookup {$account.personalInfo.userName} # 



Click OK 



The Value pane now displays the new macro. 
7. Click OK 



Task 4. Test the data source property macro. 

You are currendy logged on as Frank Bretton. You will test this account first. 

1 . In the Project Viewer, under Consolidation View> Return Reason, test the 
Return Reason Description query item (you can choose to test any other 
query item if you wish) . 

2. Click the Query Information tab. 

The results appear as follows: 

Cognos SQL 

select 

RE TURN_RE AS ON . REAS ON_DE S CRI FT I ON_EN a s REAS ON_DE S CRI PT I ON_EN 

from 

|gosales| . ,GG SALES .RETURN REASON RETURN_REASON 

Notice the data source connection name. You will now log on as a different 
user to dynamically use another data source connection. 

3. Click Close. 

4. Log off, and then log on again with scottb (password — Educationl!) . 
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5. Test the query item again. 

The results appear as follows: 

Cognos SQL 

select 

HE TURHEEAS ON . REAS ON_DE S CRI FT I ON_EN a s REAS ON_DE S CRI PT I ON_EN 

from 

I GO SALE Sal -GOSALES. RETURN REASON RE TURN_RE AS ON 

Notice the data source connection name has changed. 

For this technique to work, ensure that the structure of the underlying data 
sources match. In other words, the database structures must be mirror images 
with the exception of the data they contain. 

6. Click Close, log off, log on as admin (password = Education!.!), and then 
save the project. 

If you test the query item again, the default value GOS ALE S in the parameter 
map would be used since the admin user is not a value in the parameter map. 

Note: You can achieve the same effect in IBM Cognos Connection by 

configuring your data source connections appropriately. For example, 
you can create one Data Source in IBM Cognos Connection, and then 
multiple connections for that data source. Each connection would point 
to a different version of the database containing region specific data. You 
would then apply security on each of the connections. When a user 
accesses the data source, they will automatically use the connection to 
which they have access. If a user has access to more than one 
connection, they will be prompted at mn time to select the connection 
they want to use. To support multiple connections for a data source in 
your Framework Manager project, you must clear the data source catalog 
and schema properties. This information will be obtained from the 
connection information at mn time. 

Results: 

Using a macro and a session parameter, you were able to 
dynamically change your data source connection based on the 
current user. 
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Business Analytics 

Examine Prompt Macros 

■ Prompt macros allow sophisticated prompting with the 
ability to: 

■ provide prompt names 

■ specify data types 

■ provide default values 

■ use Prompt Info properties 

■ append text 

■ make filters and prompts optional 

■ request single or multiple values 

Coanos. 

software 

©2010 IBM Corporation 



Data types include the token data type, which is used for passing SQL syntax. 

You can reference query items allowing the use of Prompt Info properties setting. 

You can append text at the beginning or end of the prompt. 

Specify a default value to make the prompt optional. If no value is specified the prompt 
is mandatory. 

You can use the prompt function for single values or the promptmany function for 
multiple values. 
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Business Analytics 

Use the Prompt Macro Function 



Prompt name 

i 



Default value 

i 



#prompt(|'Select language of preference'|J'token' / f EN 1 D# 




Data type 



Coanos. 
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The prompt macro above allows the end user to enter a single value, in this case a 
token value, to dynamically affect the SQL generated for selecting a language based 
column. 
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Business Analytics 


5 = == 


Use Preceding Text in a Prompt 




Prompt name 

1 


Data type 

1 


# promptf 'Enter data source numberU'int'] 




'great_outdoors_wa rehouse' r 


'great_outdoors_warehouse )# 




f 

Default value 


t 

Preceding text 






Coanos. 

software 
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This prompt macro uses the prompt function with preceding text to allow end users to 
select the data source to which they would like to connect. 

The prompt macro uses preceding text to specify the data source name which is 
concatenated to a value supplied by the user. If the user supplies a value of 2, it will 
result in a data source name of GOSALES2. 
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Demo 4: Create Prompt Macros to Filter Data 



Purpose: 

Report authors would like the ability to specify which language they 
view the data in at run time. This applies to all queries they write. To 
facilitate this, you will alter your centralized language macro to 
generate a prompt at run time. 

Rather than connect to a data source based on their user ID, authors 
have requested to choose the data source to which they would like 
to connect. You will use a prompt function in the data source 
properties to accomplish this. 

Authors would also like to be prompted for the return reason for 
returned items and be able to supply one or more values for Return 
reason code. 

Component: Framework Manager 

Project: GO Operational 

Task 1 . Create a prompt macro to select a specific language 

column based on user input. 

The following macro will use the token data type to pass SQL at run-time to 
dynamically select a specific language column from a table based on the user's input. 
Currently, some of our model query subjects use a centralized macro (created earlier 
in this module) to dynamically select a language column based on the user's locale. 
You will change this centralized macro to allow the user to specify the data language. 

1 . In Framework Manager, from the Project menu, click Session Parameters. 
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2. In the Value field for the UserLanguage model session parameter, change the 
existing macro from #$Language_lookup{$runLocale}# to #prompt(' Select 
language of preferenceYtokenQEN’)#. 

This macro passes SQL syntax to append the language code value to the 
column name the user wishes to select. If no value is provided, the default value 
is set to EN, which will return data in English. 

This is a good example of how a centralized macro can save time. This one 
change will be reflected throughout the model. 

3. Click OK 

4. In the Project Viewer, in the Consolidation View, right-click Order Method, 
click Test, and then click Test Sample. 

5. In the Prompt Values dialog box, specify a value of FR, ensure Always 
prompt for values when testing is selected, and then click OK. 

Notice that the values in the Order Method column are in French. 

6. Click the Query Information tab. 

The results appear as shown below: 

Cog nos SQL 

select 

| ORDER METHOD . ORDER METHOD FR | as OrderMetbod, 

ORDERME THOD . ORDER_ME T BOD_C ODE a s ORD E R_ME THODC ODE 

from 

GO S A LE S . . GO SALES. ORDER_ME T HOD ORDER_ME THOD 

Notice that the Order Method column is suffixed with FR. The FR at the end 
of this column name is the value you provided and was appended to the SQL at 
mn time. 

7. Click the Test tab, click Test Sample again, clear the FR prompt value, and 
click OK. 

The results are returned in English because the prompt macro is supplying the 
default value of EN. 

8. Click Close. 
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Task 2. Apply a prompt macro in the data source properties. 

1 . Select the GOSALES data source. 

2. In the Properties pane, for the Content Manager Datasource property, 
change the macro to the following: 

#prompt(’ Enter data source number’, 'int', ’GOSALES’, ’GOSALES’)# 

This prompt syntax requests a number value from the user and appends it to 
the preceding text specified, in this case, GOS ALE S. If no value is specified, 
then the default value of GOSALES will be used. 

3. Click OK, and then test Order Codes. 

4. In the Prompt Values dialog box, specify a value of 2. 

5. Click OK, and then click the Query Information tab. 

The results appear as follows: 

Cog nos SQL 

select 

Orde r_C ode s . 0 r de r_Nxmib e r as Or de r_Nxmib e r , 

Orde r_C ode s . O rde r_De t a i 1_C ode a s Or de r_De t a i i_C o de 

from 

{ select 

ORDER_DE TAILS . ORDER_DET?AI L_CQDE as 0 r de r_De t a i 1_C ode P 
ORDER_DE TAI L S . ORDER_NUHBER as Or de r_Nxmib e r 

from _ 

bo SALES a . .GOSALES. ORDER_DE T AI LS ORDER_DE TAILS 

) Order_Codes 

Notice the data source name is GOS ALE S2. The value of 2 provided in the 
prompt was appended to the preceding text GOS ALE S. This query has gone 
against the GOSALES2 data source. 

6. Test the data again, but this time clear the value of 2 and leave it blank. 
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7. Click the Query Information tab. 

The results appear as follows: 

Cog nos SQL 

select 

Orde r_C ode s . Orde r_Nnnita e r as 0 r de r_Nxmib e r , 

Orde r_C □ de s . Orde r_De t a. i 1_C ode as Orde r_De t a i i_C o de 

from 

{ select 

ORDEK_DE TAI L S . ORDER_DE T AI L_C ODE as Or de r_De t ai 1_C o de f 
ORDER_DE TAI L S . ORDER_NUHBER as Or de r_Nxmib e r 

from 

IgosalesL .gosales.order_details order_details 

) Order_Codes 

Notice the data source name is now GOSALES. The default value of 
GOSALES is used. This query has gone against the GOSALES data source. If 
you provided a value of anything other than 2 at this point would return an 
error since there is no data source configured other than GOSALES and 
GOSALES2. 

8. Click Close. 

Note: Again, you can achieve the same effect in IBM Cognos Connection by 
giving a user access to more than one connection associated with a Data 
Source defined. If a user has permissions to access more than one 
connection for a data source, they will be prompted at mn time to select 
a connection. 
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Task 3. Apply a filter to the Return Reason Dimension query 

subject. 



1 . 

2 . 



3 . 

4 . 



In Consolidation View, double-click the Return Reason model query subject 
to open the Query Subject Definition dialog box. 

Click the Filters tab, and then create a filter called Prompt Many for Return 
Reason with the following syntax: 

[Consolidation View] . [Return Reason] . [Return Reason Code] in 
(#promptmany(’Enter Return Reason Codes(s)yimeger’)#) 

Click OK, click the Test tab, and then click Test Sample. 

You are prompted to enter values. 

Click the Value field for Enter Return Reason Code(s). 



The results appear as follows: 



Provide a value: 



Choices 




OK. 



Cancel 



A multi-value prompt dialog box appears. 
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In the Provide a value box, type 1, and then click the right arrow 
the value to the Choices list. 



to add 



6. Repeat to add the values 3 and 5. 

7. Click OK, click OK again. 



The results appear as follows: 



Test results 




Return Reason Description 


Return Reason Code 


Defective product 


i 




Wrong product ordered 


3 




Unsatisfactory product 


5 



Only the values you typed are returned. This is a mandatory prompt since no 
default values have been provided. If you do not provide a value, you cannot 
proceed beyond the prompt. 

8. Click OK, and then save the project. 

Results: 

You implemented three filters using prompt macros, allowing report 
authors to easily refine their reports or select their data source. 
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Business Analytics 



Security Macro Functions 

■ Five macro functions associated with security 



Available Components: 










E B) 


Parameter Maps 






1 *,. 


Session Parameters 




E 


Macro Functions 






Pfl 








fc) 


CAMIDbst 










CAM IDLslForType 








ffr) 


CAM Passport 








ffc) 


CSVfcferttyName 










C S Vlden^ t“Jame List 










_add_days 






J&L 


add marnhs 



Coanos. 

software 
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The macro functions above retrieve security related information from a user's session 
and can be used in a macro to filter data or display user information in a calculation. 
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Business Analytics 

CSVIdentityName 

■ Retrieves account, group, and role information for the 
current user 

■ Use with a parameter map to implement row-level 
security based on values stored in a data source 




^CSVIdentityNamefY dSecurityLookupD #) 



Parameter Map 



Database Table 



Key 


Value 


Americas 


NA 


Europe 


EU 


Australia 


AU 




I 

v 



Country 


City 


Security_Access 


Canada 


Toronto 


NA 


Germany 


Frankfurt 


EU 


United States 


New York 


NA 



Coanos 

software 
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You can use the CSVIdentityName macro function as a key in a parameter map. 
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Business Analytics 



CSVIdentityNameList 

■ Returns a separator delimited list of the account, 
group, and role information for the current user. 



[Business view]. [Retailer site]. [City] 
(#CSVIdentityNameList()#) 7 



in 



Database Table 



Country 


City 


Canada 


Toronto 


Germany 


Frankfurt 


France 


Lyon 



[Business view]. [Retailer site]. [City] in 
('Everyone', 'Authors', 'Lyon') 



Resulting 
Filter 



Coanos. 

software 

©2010 IBM Corporation 



You can use the CSVIdentityList macro function to filter on data that has the same 
name as the account, group or role information returned in the delimited list. 

In the slide example, the city column would be filtered on Lyon. 
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Demo 5: Leverage a Macro Function Associated with Security 



Purpose: 

A request has come in to let authors filter their reports based on 
retailers located in their city. The IT department has set up an LDAP 
authentication provider with groups based on city names and has 
added the appropriate users to each group. With this knowledge, 
you can leverage the group names from the authentication provider 
in your filter through the CSVIdentityNameList macro function. 

There is also a requirement for authors to obtain their personal IBM 
Cognos security information. To accomplish this, you will create a 
calculation that will return this information for them. 



Components: Framework Manager, Business Insight Advanced 

Project: GO Operational 

Package: GO Operational (query) 

Task 1 . Create a filter using the CSVIdentityNameList macro 

function. 

1 . In Framework Manager, in the Presentation View namespace, right-click the 
GO Operational Sales (query) namespace, create a new filter called Retailers 
Near Me. 

2. In the Available Components pane, expand Consolidation View> Retailer 
by Location, and then add Retailer City to the expression definition. 

3. In the Expression definition pane, after [Consolidation View] . [Retailer by 
Location] . [Retailer City] , type in (. 

4. Under Available Components, click the Parameters tab, and then expand 

Macro Functions. 
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5. Double-click CSVIdentityNameList to add it to the expression definition, and 
then type ) to finish the expression. 

The results appear as follows: 

[Consolidation View] . [Retailer by Location] . [RTL_CITY] in 

(#CSVIdentityNameList()#) 

Notice the comma- separated list that appears in the Tips pane. 

[Consolidation View], [Retailer by Location], [RTL_CITY] in( Admin Person'.. All 
Authenticated Users 1 .. 'Cognos'.. 'Consumers 'Everyone 1 .. 'LDAP', 'Readers', 'System 
Administrators' ) 

This list is alphabetical and indicates the user's name and all the groups and 
roles to which they belong. The test user you will use is Daniel Turpin who 
belongs to a group called Lyon named after the city where he works. 

6. Click OK, and then log off and log back on with as turpind (password 
Educationl!) . 

7. Double-click the Retailers Near Me filter. 

The results appear as follows: 

Expression definition: I - Auto urn 

(Consolidation View]. JRetailer by Location]. [Retailer City] in 
{SCSVIdentityNameListO#) v 







[Consolidation View] .[Retailer by Location] .[Retailer City] in 
fAII Authenticated Users f£w«umers , 'Daniel Turpin'. 
"Everyone" , 'Local LDAP .rL^on'l "Query Users . "Readers , 
"Sales Reps'} 



Notice the group called Lyon. 



8. Click OK, log back on as admin (password — Educationl!), and then save the 
project. 
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Task 2. Publish the GO Operational (query) package and test 

it in Business Insight Advanced. 



1. Under Packages, double-click GO Operational (query), and then select 
Retailers Near Me. 



2 . 

3 . 

4 . 

5 . 




The results appear as follows: 



3-1 x 



GO Operational Model 



X t | ‘S Presentation View 

GO Operational Sales (query) 





✓ b 



✓ b 




Sales (query) 

Returns (query) 

Sales Targets (query) 
y/bl f^ul Retailer Location Filters 




My Location 



Retailers Near Me 



v l_|[qpl m n iZi r~^it i i~i -=i I Q ■=.!.=. l~- ' Zi r~i Zi h 



ir-ir- 



Click OK, and then publish the GO Operational (query) package. 

In IBM Cognos Connection, log on as turpind (password = Educationl!) . 



Launch Business Insight Advanced selecting the GO Operational (query) 

package for a List report. 

Expand Sales (query), and then add the following items to the report: 



Query Subject 


Query Item 


Retailer by Location 


Retailer City 
Retailer N ame 


Sales Fact 


Revenue 



Group the report on Retailer City. 
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MANAGER 



7. Drag the Retailers Near Me filter onto the report. 
The results appear as follows: 



iiiiipr City' 


Reta ile r N a me 


Reven ue 


Lyon 


Air marin 


53.243.477.50 




Amis de montagne 


53.639.130.52 




Amis port 


55.395.231 .79 




Camping Sauvage 


54.704.753.74 




Conception franchise 


517.175.057.69 




Cordages Discount 


53,119.130.33 




Galerie Sport 


53,154.265.75 




Golf Plaza 


55.745,340.93 




Golf Plus 


54.270.750.10 




Jeunesse active 


54.962.935.15 




Monde de sport 


55.525.600.69 




SportsClut 


54.151.322.56 


1 


Equipement camp ant 


54.450.034.57 



Lyon - Summary $50,592,636.47 



The report is now filtered on Lyon since that is the group to which Daniel 
Turpin belongs. 

8. Return to IBM Cognos Connection without saving the query. 
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Task 3. Create a calculation to retrieve a user's IBM Cognos 

security information. 



1 . 

2 . 






In Framework Manager, right-click the GO Operational Sales (query) 
namespace, point to Create, and then click Calculation. 

In the Name box, type My Security Info. 

You will use the sq (single quote) function, the csv (comma separated values) 
function, and the C AM ID I a stForT ype function to return the user's roles. The 
sq function places the entire results in single quotes making it a string. The csv 
function takes the results of the C AM ID I istForT ype function and separates the 
values with a comma. And finally the CAM ID ListForType retrieves specific 
security information for the user based on a parameter. You can request the 
user's roles, groups, or account. 

Use the Parameters tab to create the following expression: 

#sq(csv(CAMIDListForType(’role’)))# 

In this expression, 'role' has been hard coded into the CAMIDListForType 
function to return the user's roles. 



Click the Test Sample 




button. 



The results appear as follows: 



est Results 




My Security Info 


'CAM 1 D (' Consumers' ']','CAM 1 D (": R eaders' ']','CAM 1 D : System Administrators' ')' 



You are currently logged on as the admin user. This user belongs to the System 
Administrators and Readers roles. You can change the 'role' value in the 
expression to 'group' or 'account' to retrieve different security information. 

Click OK, save the project. 



1 9-44 © 2003, 201 0, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 





USE ADVANCED PARAMETERIZATION TECHNIQUES IN FRAMEWORK MANAGER 



Task 4. Test the security information calculation in Business 

Insight Advanced. 

1 . Add the My Security Info calculation to the GO Operational (query) 

package definition, and then publish the package. 

2. In IBM Cognos Connection, launch Business Insight Advanced, and then 
select the GO Operational (query) package for a List report. 

At this point, you are still logged on as turpind in IBM Cognos Connection. 

3. In Business Insight Advanced, drag the My Security Info calculation to the 
work area. 

This user belongs to three roles, the Query Users role, Consumers role and the 
Readers role. 

4. Return to IBM Cognos Connection without saving the query. 

Results: 

Using the CSVIdentityNameList macro function, you created a 
model filter that lets authors filter their reports based on retailers in 
the city where they live and work. 

You also created a calculation to return users' security information. 
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Workshop 1 : Make the Security Information Calculation 

Dynamic 



Component: Framework Manager, Business Insight Advanced 

Project: GO Operational 

Package: GO Operational (query) 

Currently the My Security Info calculation is hard coded to display a user's roles. Users 

would like the flexibility to show different information such as their account info or 
groups they belong to. 

To accomplish this, you will need to add a prompt macro to the calculation expression. 
Make sure the prompt name indicates the appropriate choices for values to be entered 
into the prompt (role, group, account) and that you specify the correct data type (the 
values submitted by the user will be used in a SQL query to the Content Store 

Make the change to the My Security Info calculation, test in Framework Manager, and 
then test in Business Insight Advanced as turpind (password = Eductionl !) using the 
GO Operational (query) package. 

Once finished you can save the project and close Framework Manager. 

For more detailed information outlined as tasks, see the Task Table on the next page. 
For the final results, see the Workshop Results section that follows the Task Table. 
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Workshop 1: Task Table 



Task 


Where to Work 


Hints 


1 . Add a 
prompt 
macro 
function to 
the My 
Security Info 
calculation. 


Project Viewer 
pane, Calculation 
Definition dialog 
box 


• Edit the My Security Info calculation 
definition to appear as shown below: 

#sq(csv(CAMIDListForType(prompt 
('Specify info type (role, group, account)', 
'token 1 ))))# 

• Test three times, supplying a different 
prompt value each time (role, group, 
account) to see the effects of the prompt 
values. 

• Save the project, and then publish the 
GO Operational (query) package. 


2. Test the My 
Security Info 
Calculation 
in Business 
Insight 
Advanced. 


Business Insight 
Advanced 


• In IBM Cognos Connection logged in as 
turpind (password=Educationl!), launch 
Business Insight Advanced selecting the 
GO Operational (query) package for a 
List report. 

• Drag the My Security Info calculation 
onto the report, and then type the word 
group in the prompt value box. 

• In Framework Manager, close the 
project, saving if prompted. 
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Workshop 1 : Results 



You will see the following prompt when testing the calculation in Framework Manager: 



Enter prompt values: 


Name 


Data Type 


Value 


Specify info type (role, group, account) String (Abe) 


group 









In query studio, the prompt should appear as follows: 



Prompt 



Provide values for the report you are about to run. 
+ Indicates a required fidld. 

Points to missing information. 

Specify info type (role, group,, account] 
Provide a value: 




If you specify group as your prompt value, the results will appear similar as follows: 

'CAMID (" : Sales Reps" ) ' , ' CAMID ( " :: All Authenticated 
Users") ' , 'CAMID (" : : Everyone") ' , ' CAMID ( "Local LDAP 
ID : g : 23ecLba01-8f 2f Ildd-80c7 8a25-58ae3caf " ) ' 
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Business Analytics 

Summary 

■ You should now be able to: 

■ identify session and model parameters 

■ leverage session, model, and custom parameters 

■ create prompt macros 

■ leverage macro functions associated with security 



Coanos. 

software 

©2010 IBM Corporation 
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and Extensibility 

IBM Cognos BI 




Business Analytics 
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MODEL MAINTENANCE AND EXTENSIBILITY 



Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ perform basic maintenance and management on a 
model 

■ remap metadata to another source 

■ import and link a second data source 

■ run scripts to automate or update a model 

■ view lineage 

■ create a model report 



Cognos* 

software 
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Business Analytics =§==:= 7 

Copy, Move, Rename and Delete 
Projects 

■ These actions: 

■ are available from File > Manage Projects 

■ allow you to organize projects in a meaningful way 

■ work on the file folder and all contents 
(except Rename) 

■ require closing the project first (except Copy) 



Cognos* 

software 
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Rename Project renames the .cpf file but no other files in the folder. If the folder has 
the same name, it is also renamed. Of course these same actions can be performed 
manually on the system files in Windows Explorer. 

If the project has segments, Copy, Move, and Delete work on all segments and the 
main project. However deleting a project segment does not delete the main project or 
other segments. Segments are discussed in more detail in another module. 
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Business Analytics 



Deploy Packages or Content 



IBM Cognos 
Configuration: 
switch URI from one 
server to another 




or 



IBM Cognos 
Connection: 

export selected content 




export 



import 




Cognos. 

software 
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When you publish a package, Framework Manager uses the Dispatcher URI (Uniform 
Resource Indicator) setting in IBM Cognos Configuration (Environment — Group 
Properties) to determine the target server. A simple way to deploy a package to a 
different server is to change this setting in IBM Cognos Configuration. This only allows 
you to deploy a package to a different environment, not content (reports, analysis, and 
so on) based on that package. For example, reports created in the development 
environment will not be deployed to the production environment using this method. 

To deploy packages and their related content, an administrator can create an Export 
Deployment Specification to export selected packages, reports, security objects, and 
other objects from the content store. These can then be imported to other IBM 
Cognos servers (such as multiple production sites). You can also create an export 
deployment of the entire Content Store. 
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Business Analytics 

Analyze Publish Impact 

■ Framework Manager feature that analyzes the effects 
of model changes on a published package 

■ Identifies: 

■ changed model objects 

■ other model objects affected by the changes 

■ reports that use the changed objects 



Cognos* 

software 

©2010 IBM Corporation 



For each object identified as a changed model item, an icon identifies whether the 
change may or will break any related reports. You can then identify specific reports 
affected by the changes, and even directly run those reports from the Analyze Change 
Impact dialog box. 

With this information, you can notify report authors that a change was made to the 
model that affects their reports. They can then fix their reports so that consumers are 
not affected. 

Something to be aware of is that changed cardinality is not detected and identified by 
this tool since changed cardinality does not break reports. It may, however, change the 
amount of data returned (outer join vs. inner join), and therefore should be discussed 
with authors. 
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Demo 1 : Perform Impact Analysis on a Modified Package 



Purpose: 

A number of reports have been created using the GO Operational 
model. You need to make some changes to the model in Framework 
Manager and re-publish the package. Before publishing, you want to 
analyze what effect this change will have on existing reports. To 
accomplish this you will perform an impact analysis on the GO 
Operational package. 



Component: Framework Manager 

Project: GO Operational 

Task 1 . Modify a model object. 

1. In Framework Manager, close any projects that may be open, and then open 

the GO Operational project located at C:\Edcognos\B5152\ 
CBIFM-Start File\Module 20\GO Operational. 

2. If prompted, log in as User ID admin, and Password Education!.!. 

3. Publish the GO Operational (query) package. 

4. In the Project Viewer pane, under Consolidation View, rename Time to 
Time (Sale). 

Task 2. Analyze the impact of changing the model. 

1 . Under Packages, click the GO Operational (query) package. 

2. Right-click the GO Operational (query) package, and then click Analyze 
Publish Impact. 

The Analyze Publish Impact dialog box appears. 
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3 . 



20-8 



In the Changed Model Items section, click Time (Sale). 

The results appear as follows: 



fril Save da Print 

Publish Inn pact for Package: GO Operational (query) 

The list below shows the package changes relevant to the reporting environment. A change in a package may have an 
effect on reports that reference it. 

Changed Model Items: Find Report Dependencies 
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Object Name 
Time 
Time 
Time 



a V 



DDD Time (Sale) 



Change 

Modified 

Modified 

Modified 

Modified 



w 



Actions 



Change details for: 

List of the relevant model item properties that have changed. 



Property 

namefen] 



Old Value 

Time 



New Value 

Time (Sale) 



Notice the red X icon, which indicates that the change you made will break 
related reports. The "Change details for" section identifies the nature of the 
change, in this case the renaming of Time to Time (Sale) . 



Under Actions, you can show the object dependencies L_ J, find the object in 




the Project Viewer or open the objects definition 
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5. 



6 . 



To the right of Time (Sale), under Actions, click Show Dependencies 

necessary, move the Analyze Publish Impact window to view the Tools 
pane. 




if 



The Dependencies tab identifies the modified query subject and its contents. 
The Dependent Objects list identifies all objects affected by it, including 
shortcuts, model query subjects and query items. 

In the Analyze Publish Impact window, to the left of Time (Sale), select the 
check box and then, above Actions, click Find Report Dependencies. 



You can choose the scope of your dependencies search. 



Click Search. 



A list of reports affected by your change is returned. Because you haven’t saved 
many class reports, making this change has little effect. You can identify the 
report the object appears in and how it is being used. Of course, in a production 
system this could identify hundreds of reports, indicating that it might not be 
practical to make this change now. You could enable model versioning to allow 
authors time to repair their reports. Model Versioning is discussed in another 
module. 

You can click on any of the report names in the list to view and edit the report 
in IBM Cognos. 

7. Click Close, and then click Close again. 

8. Click Undo to restore the original name to Time, and then save the project. 

Results: 

You made a change to the GO Operational model in Framework 
Manager. Before you re-published, you analyzed the package to 
determine what effect this change to the model would have on 
existing reports. 
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Business Analytics 

Remap An Object to a New Source 

■ Useful when underlying objects have changed 

■ Remaps objects to new items 

■ Typically used to remap middle layer(s) to new or 
changed data source items 

■ Remaps automatically (based on name matching or 
by object reference) or manually (drag and drop) 
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The remapping feature can be very useful in remapping your consolidation view 
(middle layer) to new or changed data source objects. For example, you may switch 
database vendors or database structures (move from an operational structure to a star 
schema structure). 

Remapping is also useful if you decide to change how you modeled an underlying 
object or objects. For example, if your Product dimension in the Consolidation View 
references two underlying query subjects (Product and Product Type) and you decide 
to merge those underlying query subjects, you can use the remap tool to point the 
Product dimension query subject to the newly merged query subject in the lower layer. 
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Demo 2: Remap the Physical Layer 



Purpose: 

You have been given a new and improved data source, 
great_outdoors_warehouse, which will replace the gosales data 
source under Foundation Objects View. Your ultimate goal is to 
remap all Consolidation View model query subjects to data source 
query subjects in the new data source. You will start this by 
remapping the Consolidation View's Time query subject to point to 
the new GO TIME DIM. 



Component: Framework Manager 

Project: GO Operational Maintenance 

Taskl. Import the new metadata. 

You will create another version of your model to perform the remapping technique. 
This will allow you to maintain a backup copy of your original project. 

1. From the File menu, click Save As and save your current project as GO 

Operational Maintenance in C:\Edcognos\B5152\Course_Project\GO 
Operational Maintenance. 

2. In the Project Viewer pane, in the Foundation Objects View namespace, 
create a new namespace called GO Data Warehouse. 

3. Right-click GO Data Warehouse, and then click Run Metadata Wizard. 

4. With Data Sources selected, click Next. 

5. Select great_outdoors_warehouse, and then click Next. 

6. Expand GOSALESDW and Tables, select GO_TIME_DIM, and then click 

Next. 
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7. 

8 . 

9. 



Click Import, and then click Finish. 

Expand GO Data Warehouse >GO_TIME_DIM. 



For all the query items displayed as Facts 
Attribute. 




change the Usage property to 



Task 2. Remap Time to GO_TIME_DIM. 

Before you remap objects, it is a good idea to find all object dependencies for 
the object that will be replaced with a new one. In this case it is the original 
TI ME _D IM E N SI ON query subject from the gosales namespace. To do this 
you will use the Dependencies feature to identify which objects will require 
remapping. 

1. In the gosales namespace, right-click TIME_DIMENSION, and then click 

Show Object Dependencies. 

In the Tools pane, on the Dependencies tab, TTM E DTM E NST ON and its 
children appear in the top pane, and dependant objects appear in the bottom 
pane. Selecting items in the top pane filters the items in the bottom pane. The 
items in the bottom pane include dependant packages, security, relationships, 
query items, and determinants. If you scroll down in the Dependant objects list, 
you can select individual query items. Each one you select receives focus in the 
Project Viewer tree. This way you can identify which objects will require 
remapping. 

2. In the Tools pane, in the Dependant objects pane, select the first Day Key. 

Consolidation View>Time>Day Key is selected in the Project Viewer tree. You 
now know this object requires remapping to the new GO TTM E DTM query 
subject. Other objects also require remapping, but for the purposes of this 
demo, you will only remap one object. 

3. In Consolidation View, right-click Time, and then click Remap to New 
Source. 

The right pane identifies the original source for all query items. 
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4. Under Available Model Objects, expand Foundation Objects View> 

GO Data W ar eho u s e > G OT I MED I M . 

Comparing left and right panes, it appears that the new query subject uses the 
same query item names as the original query items. You can drag each query 
item from the left to the right pane individually, or you can use the matching 
criteria feature. Note that 'Use matching criteria options' is selected. 

5. Click Options. 

You see that the default for matching criteria is to remap to by name. 

6. Click Cancel, and then drag GO_TIME_DIM to anywhere in the right pane. 



1 Name 


Remap To 


Original Source 1 


|| Year 




[gosales]. [T 1 M E Di 


Quarter Key 


[G 0 D ata Warehouse]. [G 0_T 1 M E_D 1 M ]. [Q UAFl TEF ... 


[gosales], [TIME_.D II 


I Quarter 


[G 0 D ata Warehouse], [G 0_T 1 M ED 1 M ]. [DJ FI FI EN' ... 


[gosales], [TIME_,D II 


| Month Key 


[G 0 D ata ’warehouse]. [G 0 _T 1 M Ej3 ! M ]. [M 0 N THJ ... 


[gosales], [TIME_D II 


| Month (numeric) 


[G 0 D ata Warehouse], [G UJ\ 1 M E_D 1 M ]. [CU FI FI EN' ... 


[gosales], [TIME_,D II 


| Month 


. . . 


[gosales], [Month] 


"c- Day Key 


[G 0 D ata Warehouse], [G 0_T 1 M E_D 1 M ]. [DAYJCEY . . . 


[gosales], [TIME_,D II 


W Date 


[GOD ata Warehouse], [G Q_T IMEJDIM]. [DAY^DAT . ._ 


[gosales], [TIME_.D II 



A match was found for all query items except one calculation. This must be 
handled manually. If a match wasn’t found because of different names, deselect 
'Use matching criteria options', and drag the individual query item from the left 
pane to the appropriate query item in the right pane. 

7. Click OK 

This produces a warning that there will be a cross join error, as there is no link 
between GO_DATA_Warehouse.GO_TIME_DIM and 
gosales.TIME_DIMENSION. You can ignore this, as you repair the two 
calculations causing this error. 

8. Click OK 

Notice that the Time icon in Consolidation View has changed. The jagged 
break indicates an invalid object. 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



20-13 




IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Task 3. Manually repair calculation. 

1. Expand Foundation Objects View>gosales>Reusable Objects> 

Model Calculations, and then double-click Month. 

2. In the Expression definition, change [gosales]. [TIMEJDIMENSION] to 
[GO Data Warehouse]. [GO_TIME_DIM], click Test Sample, and then 
click OK 

3. In Consolidation View, click Time, and then from the Tools menu, click 

Update Object. 

This causes Framework Manager to reevaluate the Time object. All query items 
now point to just one data source query subject, which eliminates the cross join 
error. The query subject icon is restored to its normal appearance. 

In a non-classroom environment, you would continue to do similar remapping 
for all the other Consolidation View objects. This work would involve handling 
any reporting traps in the new GO Data Warehouse namespace before 
remapping. Once you have completely replaced references to gosales with 
references to GO Data Warehouse, you would delete the gosales namespace. 
You would also move the Reusable Objects folder into the GO Data 
Warehouse namespace. In the interest of time, you will skip these steps. 

4. Save the project. 

Results: 

You have remapped your Time model query subject to a new data 
source query subject, and are ready to continue the remapping from 
gosales to GO Data Warehouse. 
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Business Analytics 



Link Multiple Data Sources 

■ You can import metadata from 
multiple data sources. 

■ To link the data sources, create 
relationships between them on 
common query items. 
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When linking heterogeneous data sources, you must create relationships on common 
data to obtain expected results. For example, if you imported an Inventory fact table 
from another data source that contained a Product Key (matching in values and data 
type to the Product Key in your existing Product dimension) you can use that key to 
create a relationship to the Product dimension. By doing so, you can create queries that 
retrieve data from separate data sources with related results. 
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Business Analytics 


= = === 


Non-Database Data Sources 




In addition to using databases as data sources for your 


models, several file types can be set up as data sources 


as well, including: 




■ Microsoft Excel spreadsheets 




■ Microsoft Word tables 




■ XML files 




■ Comma separated value (CSV) files 
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Often, files will need an ODBC connection through Microsoft Windows or IBM 
Cognos Virtual View Manager to enable the use of individual files as data sources. 
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Demo 3: Create a Microsoft Excel Data Source 



Purpose: 

A manger has an Excel file he uses to identify particular employees 
he wants to monitor for special projects. He has asked you to set up 
his pick list as a data source for such purposes. 



Component: Framework Manager, Business Insight Advanced 

Project: GO Operational 

Task 1 . Set Picklist.xls as an ODBC Data Source. 

1. Open C:\Edcognos\B5152\CBIFM-Start Files\Module 20\PickList.xls 

in Microsoft Excel. 

2. Select all the populated cells, and then from the Insert menu, click 

Name>Define. 

The Define Name dialog opens. 

3. In the Names in Workbook text box, type PickList, and then click OK 

4. Save the spreadsheet to the desktop and exit Excel. 

Since this is a training environment, we are using the Desktop. In your 
organization’s environment, use the Cognos server. 

5. Go to Start>Control Panel> Administrative Tools>Data Sources (ODBC). 

6. Click the System DSN tab, and then click Add. 

The Create New Data Source dialog opens. 

7. Select Microsoft Excel Driver (.xls), and then click Finish. 

8. In the Data Source Name text box, type PickList, and click Select Workbook. 

9. Navigate to the Desktop, select PickList.xls, click Open, and then click OK 
three times. 
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Task 2. Import PickList into the Project. 

1 . Return to Framework Manager. 

2. Right-click the Foundation Objects View namespace, point to Create, and 
then click Namespace. 

3. Rename Namespace to PickList. 

4. Right-click the PickList namespace, and then click Run Metadata Wizard. 

5. Ensure that Data Sources is selected, and click Next 

6. Click New. 

7. Click Next. 

8. In the Name box, type PickList, and click Next. 

9. In the Type list, select ODBC, leave the default isolation level, and then click 

Next. 

10. In the ODBC data source text box, type PickList. 

11. Scroll to the bottom of the page and select the No authentication radio 
button. 

12. Click Test the connection, and then click Test. 

The View the results - Test the connection page appears indicating that the test 
succeeded. 

13. Click Close, and then click Close again. 

14. Click Finish, and then click Close. 

15. Ensure the newly created PickList data source is selected, and then click Next. 

16. In the list of objects, expand PickList>Tables>PickList. 
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17. Select the following initial tables: 

Staff Name 
Sales staff code 
Branch Code 

18. Click Next, leave the defaults for the Generate Relationship criteria, and then 
click Import. 

The import process begins, and then a message appears summarizing the seven 
query subjects and six relationships that were imported. 

19. Click Finish. 

20. In the PickList query subject, change the Usage property of Sales staff code 
to Identifier. 

Task 3. Build relationships. 

1. In the Project Viewer pane, select the following items: 

• PickList/PickList> Sales Staff Code 

• gosales / Sales fact> SALES_STAFF_CODE 

2. Right-click one of the selected items, and then click Create Relationship. 

3. Click OK. 

4. Create the following relationships, clicking No if asked to replicate the existing 
underlying relationships: 

• PickList (Sales staff code, 1..1) to 
SALES_TARGET (SALES_STAFF_CODE, l ..n) 

• PickList (Sales staff code, 1..1) to 
Returns Fact (SALES_STAFF_CODE, l..n) 

You now have added the metadata for your Microsoft Excel Pic kL ist 
spreadsheet to your model and linked it to the rest of the metadata in your 
model. 

5. Publish the GO Operational package. 
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Task 4. Create an ad hoc query. 

1 . Open Business Insight Advanced and select the GO Operational package 
for a List report. 

2. In the PickList namespace, expand the PickList query subject, and then 
double-click the Staff name query item. 

3. Repeat step 2 to add the following items from the gosales namespace: 



Query Subject 


Query Item 


Sales Fact 


Revenue 


SALE S_T ARGET 


SALE S_T ARGET 


Returns Fact 


Return Quantity 



Only the Sales Reps listed in the Pick List display in the report. 

4. Close Business Insight Advanced without saving the report. 

5. Save the project. 

Results: 

You have connected to a new data source, imported the metadata, 
and then built a relationship between the query subjects of the two 
data sources in your model. 
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Business Analytics 

Play Back Parts of an Action Log 

■ All modeling actions are written to an action log file. 

■ Save specific recorded actions to play back later. 

■ Useful for: 

■ repeating identical sequences within a model 

■ creating a starting point for multiple similar models 

■ moving a model change from test environment to 
production 

■ auditing or troubleshooting 

■ bulk upgrades in batch mode 
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Each sequence of actions that you perform in Framework Manager is considered a 
transaction. Each transaction is recorded in the action log file. You can view the history 
of transactions, and play back individual transactions or a combination of transactions 
in a log file. You can also save transactions to a separate log file (script). 

The action log file is an XML file that is stored in the project folder. 

When troubleshooting a model with IBM Cognos Customer Support, the technical 
analyst will likely request the log files to be sent in. 
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Business Analytics 

Synchronize Projects 

■ Use log files to synchronize a project with changes in 
the metadata source. 

■ All actions performed in the model are replayed. The 
result is: 

■ a new project is created 

- metadata is re-imported to capture any changes 

■ the entire modeling process is repeated using 
updated metadata 
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The Synchronize feature is found in the Project menu of Framework Manager. 

You can choose to accept the new changes and create a new project, or return to the 
original project. If you accept the new changes, the original project is deleted. 

The Synchronize dialog box includes a check box to back up the original project before 
synchronizing. We recommend that you select this check box. 
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Business Analytics 

Check a Project 

■ High-level: Verify selected objects 

■ identifies invalid relationships, references, and 
object definitions 

■ offers automated or manual repairs 

■ Low-level: Run model advisor 

■ identifies design issues around relationships, 
determinants, and other model factors 

■ offers direct links to online help for resolving issues 
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These two tools have already been used and examined earlier in the course and are 
options available by right-clicking any objects in your model. They can be invoked at 
any time in the modeling process. 
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Purpose: 

You are making some changes to your project in a test environment. 
You will be adding a Business view folder and adding a query 
subject to it. You have a corresponding model in a production 
environment, but it does not contain the changes you are making. 

To save development time, you will create a script based on the 
actions performed on the project in the test environment, and then 
run that script on the project in the production environment to apply 
those changes. 

Component: Framework Manager 

Project: GO Operational Maintenance 

Task 1 . Model a business view for report authors in the test 

environment. 

1 . In the Project Viewer pane, in the GO Operational Model namespace, create 
an empty folder called Business View. 

2. Right-click the Business View folder, point to Create, and then click Query 
Subject. 

3. In the Name box, type Retailers, leave the default selection to define the data 
to be used to create the query subject, and then click OK. 

4. In the Available Model Objects pane, expand Foundation Objects View> 
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5. Add the following items to the Query Items and Calculations pane: 



Query Subject 


Query Item 


RETAILER_TYPE 


TYPE_NAME_EN 


Retailer & Retailer Site 


RTL_ADDRESS1 

RTL_ADDRESS2 

RTL_CITY 

RTL_COUNTRY_CODE 



6. Click OK. 

The Retailers query subject now appears within the Business view folder. 

7. Save and close the project. 

This updates the log file that has been generated for this session. If you wish, 
you can examine the timestamp for this projects log.xml file in Windows 
Explorer. 

Task 2. Create a script for the creation and population of the 

Business View folder. 

1. Under Recent Projects, open the GO Operational Maintenance project. 

2. From the Project menu, click View Transaction History. 

3. Under Transaction list, expand C:\Edcognos\B5152\Course_Project\ 
GO Operational Maintenance \log.xml entry (first entry in the list). 
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4. Scroll down to the bottom of the entry and then expand the last child entry. 
The results appear as follows: 

Transaction list: 



5. 



□ 2008-1 0-23 Student 

282 Set the active locale to English. 

283 Create a Folder with name "Business View" in [GO Operational Model]. 

Move into [GO Operational Model]. [Business View] the following list of objects 

284 Update the model object. [GO Operational Model]. [Business View] 

Update the model object. [GO Operational Model]. [Retailers] 

Update the model object. [GO Operational Model]. [Retailers] 

Update the model object. [GO Operational Model]. [Retailers] 

Update the model object. [GO Operational Model]. [Retailers] 

Update the model object. [GO Operational M odel]. [R etailers] 

Evaluate the definition and update the status/properties/children for the follow 

■■ FS3 Savp 

Select 'Create a folder with name Business View' and 'Update the model 
object' entries. 



The results appear as follows (preceding numbers may be different) : 



T ransaction list: 



02008-1 0-23 Student 
{-■ 0 282 Set the active locale to English. 

0 283 Create a Folder with name "Business View" in [GO Operational Model]. 

Move into [GO Operational Model]. [Business View] the following list of objects: 

0 284 Update the model object. [GO Operational Model]. [Business View] 

Update the model object. [GO Operational Model]. [Retailers] 

Update the model object. [GO Operational Model]. [Retailers] 

Update the model object. [GO Operational Model]. [Retailers] 

Update the model object. [GO Operational Model]. [Retailers] 

Update the model object. [GO Operational Model]. [Retailers] 

Evaluate the definition and update the status/properties/children for the follow 
Save 



6. Click Save as Script. 

7. In the File name box, type Create Business View, and then click Save. 

8. Click Close. 

9. In Project Viewer, expand the GO Operational Model namespace, click the 
Business View folder, and then press Delete. 
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Task 3. Run the script in the production environment to 

recreate the Business view folder. 

You will now assume that you are in the production environment. You will recreate 
the Business View folder using the script you created in the test environment so that 
it appears in the production environment. 

1. From the Project menu, click Run Script, and then double-click Create 
Business View.xml. 

2. Ensure that all check boxes are selected, and then click Run. 

A status message quickly appears and then a transaction message appears in the 
Transaction details pane. 

3. Click Accept, and then expand Business View and Retailers. 

You successfully recreated the objects using a script. 

4. Save and close the project. 

Results: 

You made changes to your project in a test environment. You 
created a script to record those actions, and you ran that script on 
your project in the production environment. The result is that all 
actions taken on your project in the test environment were applied, 
and are now reflected in the production environment. 
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Business Analytics 

Lineage 

■ Lineage information traces an item's metadata back 
through the package and the package's data sources. 

■ Two types: 

■ IBM Cognos-only 

■ Third-party provider with a URL interface 

■ Accessed : 

■ in Cognos Viewer (HTML reports only) 

■ in the data tree in the studios 

■ through the IBM Cognos BI SDK 

Cognos. 

software 
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Modelers and authors alike can use lineage in the IBM Cognos studios and Cognos 
Viewer to trace metadata back to the data source. This can be a useful tool in helping 
authors and modelers work together to refine the model to meet requirements. 

Lineage can be disabled or enabled on a package-by-package basis through object 
capabilities. 
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Business Analytics 



Lineage Views 



Business View 

Order Invoices - Donald Chow, Sales Person 

Description Generates invoices of sales by Donald Chow, 



Owner 

Contact 

Package 

Report Item 1 

Name 

Path 

Expression 

Referenced Package 
Items 




GO Sales (query) 

Package based on relational view. 



Admin Person 

Name 
Description 

Price 

Order Invoices - Donald Chow, Sales Person > Query - Order Invoice > Price 
[Sales (query)]. [Sales].[Quantity] * [Sales (query)].[Sales].[Unit price] 

Name Quantity 

| Path Order Invoices - Donald Chow, Sales Person > GO Sales (query) > Sales (query) > Sales > Quantity 



Technical View 



Report 



Package 



Data Sources 



ygg Query - Order Invoice 


■ > 


Sales 




jjgg O RD E R_D ETA I LS 






Quantity 


QUANTITY 




[~)gosales 


Prfc* 


► 


f ► 


1 > 


Unit price 


UNIT_PRICE 







Properties for Price 
Property 
ID 

Name 

Type 

Expression 

Datatype 

Precision 

Scale 

Regular Aggregate 



Value 

[Query - Order Invoice]. [Price] 

Price 

Data Item 

[Sales (query)]. [Sales). [Quantity] * [Sales (query)].[Sales].[Unit price] 
Decimal 
30 
2 

Sum 



Technical View 



Cognos. 

software 
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Users with access to any of the studios will have access to two tabs in the lineage 
results, a Business View tab and a Technical View tab. Consumers will only see the 
Business View results. 

Business View - contains a textual, abbreviated form of lineage that is intended to 
provide some basic information to an end user such as descriptions, expressions, data 
source and contact information. 

Technical View - provides a graphical representation as well as detailed information 
about the data flow from the metadata tree or report back to the data source. 
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Business Analytics ^==^~i 

Integration with Metadata 
Workbench 

■ For IBM Cognos vlO.l, we have introduced tighter integration 
with InfoSphere Metadata Workbench. 

■ You can now leverage IBM Cognos Lineage Viewer for report and 
package information and can invoke InfoSphere Metadata Workbench 
to drill down into data source level information 

■ This new entry point for Metadata Workbench gives you the 
ability to leverage the best of both products with the following 
advantages 

■ Ease of deployment and maintenance for IBM Cognos Lineage 

■ Exploration and analysis power of Metadata Workbench 

■ Flexibility to manage access to different levels of information 



Cognos. 

software 
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Purpose: 

As a consumer, author or modeler, you may like to gain more 
information about the data reports. You will use the Lineage feature 
in Cognos Viewer, as well as in the metadata tree of the studios, to 
retrieve the additional information. 

Component: IBM Cognos Connection, Cognos Viewer, Query Studio 

Package: GO Sales (query) 

Task 1. View lineage from Cognos Viewer. 

1 . Launch IBM Cognos Connection, log on as admin 
(password=Educationl!), and then click IBM Cognos content. 

2. Navigate to Public Folders>Samples>Models>GO Sales (query)> 

Report Studio Report Samples. 

3. Click Order Invoices - Donald Chow, Sales Person. 

The report runs and displays in Cognos Viewer. You would like to see how the 
Price values were derived. 
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4 . 
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Right-click Price in the report, and then click Lineage. 
The results appear as follows: 




The Business View tab is displayed. If you were logged in as a consumer, you 
would only see this view and not have access to the technical view. 

The Business View displays basic information about the owner of the report, 
and the name of the package it is based on. For the Price data item, it provides 
the following information: what its path in the report is, how it was calculated, 
what the names and paths of the items used in the calculation are, and the name 
of the data source the items came from. This information typically gives 
consumers enough information to understand the data they are viewing, or at 
the very least who to talk to about the report. 

For more technical users such as authors, you can view the information on the 
Technical View tab. 
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5. Click the Technical View tab. 
The results appear as follows: 
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Report 



Technical View 







jfjgQiJery " O 

Price 

St aff n ame 
■" Detail Filter 1 



Properties for Price 
Property 



Value 



Package 



Sales 
Quantity 
Unit price 



+■ 



DOG 



Sales staf 



St aff name 
^21 Embedded 



jjjjORDER.D 
,-►] QUANTITY 
UNIT_PRICE 



Sales staf 

i_|^J First name 
q^- Last name 
^ Department 
^2 Embedded 



Data Sources 



ODD 



EMPLOYE 



FIRST _NAME 
LAST_NAME 



QUO 



POSITION 



DEPARTMENT C 






] gossles 



]gosales2 



Name 

Type 

Expression 



Price 

Report Item 

[Query - Order Invoice]. [Price] 



The flow of the metadata from the report back to the data source is displayed. 
The flow begins in the Report section, showing the item in question and the 
query it belongs to, followed by the Package section, which shows all relevant 
model objects, and finally the data source section which indicates the data 
source name (or names if more than one was used to create the data item in 
question) . 



Clicking on any of the items in the diagram will change the information in the 
Property pane specific to the item that has focus. Currently the Price data item 
from the report has focus. The information provided includes the nature of the 
calculation, the datatype, and the aggregate function used, in this case Sum. 
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6. Click on the Query - Order Invoice header. 

The Property pane results appear as follows: 



7t - Query - Ordei 



Price 

Stiff name 
C Detail Filter 1 





Properties for Query 


- Order Invoice 


Property 


Value 


ID 


[Query - Order Invoice] 


Name 


Query' - Order Invoice 


Type 


Query 


Source 


< mo d e 1/ > 



The property pane now displays information specific to the report query 
containing the data item Price. 
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7. In the Package section, click on the ORDER_DETAILS header. 
The results appear as follows: 



ids 



P rice 



Properties for ORDE R_DETAILS 
Property 



■H 

* 



III Query - Order Invoice 

Pr'ce 

Staff name 
^ D etai Ffeer 1 



> 



□no 



Sales 



Quantity 
Uni prioe 



Value 



> 






□DO 



ORDER DETAILS 



QUANTITY 
UNIT PRICE 



III Sa les sta f f 




Staff rame 




— 

— 





Sa les sta f f 



DDD 

Frst name 
Last "a ne 



ID 

Name 

Type 

Definition Type 
SQL 

Table Type 



[ g osa les] . [ 0 RD ER_D ETAILS] 
ORDER_DETAILS 
Query Subject 
Data Source 

S e le ct *fro m[ g o sa les] . 0 RD ER_D E TA ILS 
Table 



The Property pane displays information such as the type of query subject (Data 
Source query subject), and the SQL used to generate the query subject. You can 
continue to click on any of the items to explore the associated information. 

8. Close the Lineage window, and then click Return. 



Task 2. View lineage from the metadata tree in Query Studio. 

1 . Launch Query Studio (it will open using the GO Sales (query) package since 
you are currendy in this package) . 

2. In the Insert Data pane, expand Product forecast (query). 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



20-35 



IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



3 . 
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Right-click Product forecast, and then click Lineage. 



The results appear as follows: 



Business View 

GO Sales (query) 

Description Package based on relational view. 

Owner Anonymous 

Contact 

Package Item 1 

INa m e Product forecast 

Path GO Sales (query) > Product forecast (query) > Product forecast 



Description 
Data Sources 




Name 

Description 



gosales 



Again, the Lineage window appears and you can investigate the metadata on 
either the Business View tab or Technical View tab. 
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Click the Technical View tab. 



The results appear as follows: 



I | Month key 



j Sales year 



Sales month 



j Branch code 



j Forecast unit price 



j Base product number \ m 



j Expected volume 



j Forecast unit cost 



> 

♦> 

> 

> 

♦> 

> 

> 

> 



000 



Product forecast 



Month key 
Seles year 
Sales month 
Branch code 
Base product number 
Expected volume 
Forecast unit cost 
Forecast unit price 
Forecast revenue 



> 

>■ 



ggj PRODUCT_FOREC AST 

SALE5_YEAR 

SALES_MONTH 

BRANCHjCODE 

BASE _P R O D U C T _N IJ M B E R 

EXPECTED _y O ULI M E 

UNITjCOST 

UNIT PRICE 



gosales 



X 



> 

* 



OUL 



Product forecast 



Forecast unit price 
Expected volume 



Because you chose to view lineage on a query subject rather than a query item, 
you are presented with all the query items that make up the query subject, both 
hidden and visible items. You can click on any item to view more information 
about it in the Property pane. 

5. Close all browser windows and then close Framework Manager. 



Results: 

By using the Lineage feature in Cognos Viewer and the metadata 
tree in Query Studio, you were able to gain additional information 
about the data used in reports. 
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Business Analytics 

Create a Model Report 



_j|] go sales 

Last Changed: 2007-11-13114:56:44 


PRODUCT JTYPE <— > SALES. 


.TARGET 


Status 


valid 


Name () 


PROOUCT.TYPE <”> SALE5_TARGET 


Expression 


[gosales] , [PRODUCT TYPE], [PRODUCT TYPE CODE 
[PRODUCT JTYPE JDODE] 


Left 


Refobj [gos3tes].[PROWJCT_TYPE] 




Mine ard one 




Maxeardone 


Right 


Re fob j [ oosales] . [S ALES_TAR GET ) 




Mine ard one 




Maxcard many 
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Select the entire model or any object within it, and then click Tools > Model Report. 
The details of every model object are presented. They can be saved in HTML or XML 
format for documentation purposes or for debugging. 

To make searching easier, we recommend that you make a separate Model Report for 
each high-level namespace and/ or folder in your project. 

The above example shows the details of a relationship within the Foundation Objects 
View. 
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Business Analytics 

Summary 

■ You should now be able to: 

■ perform basic maintenance and management on a 
model 

■ remap metadata to another source 

■ import and link a second data source 

■ run scripts to automate or update a model 

■ view lineage 

m Al 

■ create a model report 



Cognos, 
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Optimize and Tune Framework 

Manager Models 
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Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ identify and implement techniques to optimize and 
tune your Framework Manager models 



Coanos. 

software 
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Business Analytics 



Materialized Views 



■ IBM Cognos queries typically aggregate data. 

■ Materialized views that contain aggregated values, 
can significantly improve performance. 

■ Database optimization can take advantage of 
materialized views. 



Base Sales Fact Table 



Materialized View 
for Sales Facts 







Measures 


Measures at 




aggregated 


the day level 


r 


to the 






month level 
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Materialization is a benefit for relational models. However it is highly recommended 
with dimensional modeling. Modeling relational data dimensionally adds another layer 
in your model which enables OLAP behaviors in reports. To provide the best 
performance, materialization in the database should be in place. 

Common database vendor implementations include: 

• Microsoft SQL Server - view index 

• Oracle - materialized view 

• IBM DB2 UDB - materialized query tables 

• NCR Teradata - aggregate join indexes 

• Informix RedBrick - VISTA 
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Business Analytics 

Achieve Minimized SQL 

■ Minimized SQL may not occur when: 

■ relationships are added to model query subjects 

■ data source query subject SQL is altered 

■ calculations, filters, or determinants are added 

■ SQL minimization should be considered as you model, 
not towards the end of development. 



Coanos. 
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There may be times when losing SQL minimization is necessary. For example, you may 
require model query subjects with overriding relationships to control query execution 
paths. You may need to change the SQL on data source query subjects to meet specific 
application needs. You may also require filters, calculations, or determinants to affect 
the SQL generation. 

Minimized SQL will have a better chance of taking advantage of database optimization 
compared to more complex SQL. 
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Set Limits on Query Execution Using 
Governors 

■ Reduce system resource requirements and improve 
performance by setting governors. 

■ You can restrict: 

■ number of report tables 

■ number of rows returned 

■ query execution time 

■ and so on 

Cognos., 

software 
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SQL is generated automatically on demand when you: 

• mn a report in an IBM Cognos studio 

• test a query subject or relationship in Framework Manager 

• create a new query subject by transforming query subjects or merging objects 

By setting governors, you can restrict the number of tables retrieved by a query and 
restrict the number of rows returned. You can also set time limits for query execution, 
and restrict character length on binary large objects (BLOBs). 

You can also set runtime activities, such as deny outer joins and cross-product joins, 
which may produce very large and resource-intensive queries. 



21-6 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 



OPTIMIZE AND TUNE FRAMEWORK MANAGER MODELS 



Business Analytics 

Reuse Data When Running Reports 

■ Allow reports to run against cached data 

■ Report does not have to re-query the database 

■ Enable by setting governor 



Coanos. 

software 
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Do your business users require that they always see the latest data? If not, take 
advantage of query re-use. 

When you run a report for the first time, the query request is sent to the database and 
the result set is returned. 

The query and result are stored in the cache for each user for their current session. 

When you mn the report again, it can often be created using the cached query and 
result set, without querying the database again. 

To take advantage of caching for reports, you can enable the Allow Usage of Local 
Cache governor on the model in Framework Manager. 

For those users that must see the latest data, consider publishing a separate package 
without the governor turned on. In this scenario, some users can leverage re-use while 
others cannot. 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



21-7 



Purpose: 

The Great Outdoors IT department has requested that some query 
limits be set on the model to reduce the load on their servers. You 
will limit the number of tables any one query can return, set a time- 
out period for queries, and limit the number of rows retrieved by 
setting the appropriate governors. 



Components: Framework Manager, Business Insight Advanced 



Project: 



great_outdoors_warehouse 



Task 1. Set the Report table limits governor. 

1. In Framework Manager, close any projects that may be open, and then open 
the great_outdoors_warehouse project located at 

C:\Edcognos\B5152\CBIFM-Start Files\Module 21\ 
great_outdoors_warehouse. 

2. Save the project as C:\Edcognos\B5152\Course_Project\ 
great_outdoors_warehouse2. 

3. From the Project menu, click Edit Governors. 

4. Change the value in the Maximum number of report tables box from 0 to 3, 
and then click OK. 

5. Save the project. 

Task 2. Test your Report table limits governor setting. 

1. Publish the GO Data Warehouse (query) package. 

Tip: Clear the Verify the package before publishing check box to save time. 

2. Launch IBM Cognos Connection, login, and then launch Business Insight 
Advanced selecting the GO Data Warehouse (query) package for a List 

report. 
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3. Expand Sales and Marketing (query)>Sales (query), and then drag the 
Product query subject to the work area. 

An error message appears. The error occurs because the query subject generates 
SQL which references more than the allowable number of tables as defined by 
the governor setting. You will need to adjust it. 

4. Click OK, and then close Business Insight Advanced and IBM Cognos 
Connection. 

You are closing IBM Cognos Connection to clear the session cache before 
testing your new governor setting in the next step. 

5. In Framework Manager, adjust the Maximum number of report tables 

governor value from 3 to 20 and save the project. 

6. Re-publish the GO Data Warehouse (query) package. 

7. Re-test the same Product query subject in Business Insight Advanced. 

The item can be successfully added to the report. 

8. Close Business Insight Advanced and IBM Cognos Connection. 

Task 3. Set the Query execution time limits governor. 

1 . In Framework Manager, in the Governors dialog box, change the Query 
execution time limit (seconds) value from 0 to 1, and then click OK. 

2. Save the project. 

Task 4. Test your Query execution time limits setting. 

1 . Re-publish the GO Data Warehouse (query) package. 

2. Launch IBM Cognos Connection, launch Business Insight Advanced, and 

then select the GO Data Warehouse (query) package for a List report. 

3. Expand Sales and Marketing (query)>Sales target (query) and Sales 
(query). 
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4. Select and drag several query items from different query subjects including 
Sales fact and Sales target fact to the work area at the same time. 

An error message appears indicating query execution time exceeds the 1 second 
limit. This governor can be adjusted as needed. For now, you will reset it to the 
default value of 0 which indicates an unlimited time limit. 

5. Close IBM Cognos Connection. 

6. In Framework Manager, set the Query execution time limit (seconds) 

governor value back to 0 . 

7. Leave the Governor dialog box open for the next task. 

Task 5. Set and Test the Data retrieval limits governor. 

1 . Change the Maximum number of retrieved rows value from 0 to 25, and 
then click OK 

2. Save the project, and then re-publish the GO Data Warehouse (query) 
package. 

3. Launch IBM Cognos Connection and Business Insight Advanced selecting 
the GO Data Warehouse (query) package for a List report. 

4. Expand Sales and Marketing (query) > Sales (query) >Product, and then 
drag Product name to the work area. 

A message appears indicating that the number of rows retrieved exceeds the 
limit of 25. 

5. Close IBM Cognos Connection. 

6. In Framework Manager, in the Governors dialog box, change the 
Maximum number of retrieved rows value from 25 to 0. 

7. Click OK, and then save the project. 

Results: 

By setting, testing, and refining our governor settings, you ensured 
that the IT department's servers will not be unnecessarily 
overloaded. 
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Business Analytics 

Run Time Model (RTM) File 

■ The RTM file: 

■ contains the package metadata 

■ is the local cache for the server to retrieve 
metadata 

■ is created on the server when a user first accesses 
a package in any studio 

is stored in <IBM Cognos install 
location >\data\cqe\RTModels 

■ increases in size depending on how much is 

published in the package cognos. 

r software 
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Only include the necessary metadata in the packages you publish for user consumption. 

The size of the RTM file direcdy impacts the open time for the package in the studios. 
The larger the file size the longer it will take to open. 



File size can be especially significant for packages that contain cube data sources, 
because the RTM files for these packages will be similar in size to the cubes. 
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Business Analytics 


= === == 


Examine Metadata Caching 

■ Framework Manager metadata: 

■ describes objects imported from your data source 


and any objects created from them 
■ is cached in the RTM file 


Cognos. 

software 
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By default, queries will use the cached RTM file metadata. 

Enabling the "Allow Enhanced Model Portability" option in the project governors 
forces the fetching of metadata from the database and not from the model. Unless the 
model is being used in multiple environments where the columns in the database could 
potentially change in data type, disable this setting during production use of the model. 
There are cases such as during a model upgrade from ReportNet to IBM Cognos 
where the metadata should not be preserved so that a subsequent resynchronization of 
the model can appropriately update the data types of the modeled data items. 
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Business Analytics 

How do Reports Use Cached 
Metadata? 



Reports 





RTM File: 
metadata cached 




RTM File has 
missing 
metadata 





Database call 
to request 
metadata 




■ Reports require metadata and descriptions of that 
metadata to fulfill queries. 

■ If any metadata is not cached in the RTM file, the 

result is additional database calls. software 

©2010 IBM Corporation 



Query performance may become an issue if there are numerous call backs for metadata. 

Once the data source connection has the metadata information, it is cached in memory 
for the duration of the connection only. The duration of the connection depends on 
many factors. 



© 2003, 2010, IBM Corporation 21-13 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Business Analytics 

When is Metadata Not Cached? 

■ Metadata is not cached when you: 

■ enable the model portability governor 

■ modify a data source query subject by: 

■ editing the SQL statement 

■ adding embedded filter or calculation objects 



Cognos., 

software 
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As the need for IBM Cognos to interactively query the underlying relational database 
for metadata increases, there is a reciprocal decrease in performance. 
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Purpose: 

With the goal of identifying how the modification of data source 
query subjects can affect query performance, you will identify when 
the queries generated from our data source query subjects are 
using cached metadata, and when they are not. 

Component: Framework Manager 

Pro) ect: great_outdoors_warehouse2 

Task 1 . View a metadata call back to the database in 

Framework Manager. 

You will first add a calculation to a data source query subjects and then view the 
effects of that calculation. 

1. In the Project Viewer, expand go_data_warehouse>Database view> 

Sales and marketing data, and then double-click SLS_S ALE S_FACT. 

2. Click the Calculations tab, then click Add. 

3. Create the following calculation called Planned revenue: 

[Sales and marketing data] . [SLS_SALES_FACT] . [QUANTITY] * 

[Sales and marketing data] . [SLS_SALES_FACT] . [UNITJPRICE] 

Now this data source query subject includes an embedded calculation. 

4. Click OK twice, and then test any query item from the SLS_SALES_FACT 
query subject. 
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5. Click the Query Information tab, and then click the Response link at the top 
of the dialog box. 

The xml response from the IBM Cognos server for this query appears. 

Notice the text shown below: 

RQP-DEF-0543 Metadata will be retrieved from the database, because a 
simple DB query subject definition with matching metadata does not 
exist. 

Whenever this message is encountered in your testing, you will know that the 
data source query subject has been altered and is no longer considered a simple 
query subject. In this case it occurs because the query subject contains a 
calculation which results in a dynamic query, which cannot be resolved using 
the metadata currendy cached in the model. 

Note: This test can also be mn in Report Studio by going to the Tools menu, 
Validate Options, and selecting Information in the Validation level list. 
Now when you validate the report, you will be able to see this message if 
it is generated. 

6. Click Close, and then remove the calculation from the SLS_SALES_FACT 
query subject and test again. 

The metadata call back message no longer appears since cached metadata is 
used. 

7. Save the project. 

Results: 

You identified when the queries generated from our data source 
query subjects use cached metadata in the model, and when they do 
not. This was achieved by viewing the query response information. 
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Business Analytics 

Control Where Queries are Processed 

■ To improve performance, control where the query will 
be processed. 

■ There are two types of query processing: 

■ limited local 

■ database only 



Coanos. 

software 
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For relational metadata, you can improve performance by selecting the appropriate type 
of query processing for the data source. You can specify whether SQL processing is 
performed by the database server or processed locally. This setting will depend on your 
database and IBM Cognos servers' processing power and other factors found in the 
documentation. 



© 2003, 2010, IBM Corporation 21-17 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Business Analytics 

Control Computation of Aggregates 

■ Computation of aggregate values can be process- 
intensive. 

■ To improve performance, specify where aggregates 
are computed (at the database or application level). 

■ There are four settings for rollup processing: 

■ Default/unspecified 

■ Extended 

■ Database 

■ Local 

Coanos. 

software 
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The default setting for rollup processing is "default" in Report Studio and "unspecified" 
in Framework Manager, but can be set to Extended, Database, or Local. 
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Demo 3: Examine Rollup Processing and Generated SQL 



Purpose: 

A report author was interested in allowing IBM Cognos to perform 
certain aggregations locally rather than at the database level. You 
will show the report author how to accomplish this in Report Studio 
and what to expect in the generated SQL. 



Components: Report Studio, Framework Manager 



Project: 



great_outdoors_warehouse 



Package: GO Data Warehouse (query) 

Task 1 . Author a report with summary values. 



1 . 

2 . 

3 . 

4 . 

5 . 



In IBM Cognos Connection, launch Report Studio selecting the GO Data 
Warehouse (query) package. 

Create a new List report, and then in the Insertable Objects pane, expand the 

Sales and Marketing (query) > Sales (query) > Retailer. 



Drag the Retailer name query item to the report. 



From Sales Fact, add Quantity to the report. 



Click the Quantity column, and then on the toolbar click Aggregate 
then click Total. 




The results appear as follows: 



J J 

Retailer name 


Quantity 


-Retailer name* 


Quantity* 


< Retailer name* 


< Quantity* 


--Retailer name* 


< Quantity* 


Overall - Total 


<Total(Quantity)> 
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Task 2. View the Generated SQL and set the appropriate 

option. 



1. From the Tools menu, click the Show Generated SQL/MDX. 

2. In the list, click IBM Cognos SQL. 



The SQL appears as shown below: 



IBM Cognos SQL 






select 

Retaier,Reteiler_name as Retailer_name, 

XSUNI{SLS_SALES_F ACT , QUANTITY for Retailer. Retailer_name ) as 
Quantity , 




XSUM{XSUM(SL5_SALES_FACT. QUANTITY for Retailer. Retalerjiame ) 
at Retailer, Retailer_nanne } as Total_Quantity_ 



Notice that Total_Quantity is totaled for Retailer.Retailer_name. This 
represents the summary total at the bottom of the report. This aggregated total 
is displayed using extended aggregates based on the presence of the 
XSUM(XSUM) function. This SQL was generated based on the default setting. 
With this setting, you always see SQL generated based on batch mode. 

3. Click Close. 



4. On the Explorer bar, point to Query Explorer [~kJ, and then click Query 1. 



5. In the Properties pane, under Query Hints, click the Rollup Processing row. 
and then in the list, click Local. 
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6. View the generated IBM Cognos SQL again. 
The SQL appears as shown below: 



IBM Cognos SQL 


- 




select 

Retailer. Retailer _name as Retailer_name r 

XSUM(SLS_S ALES_FACT . QUANTITY fbr Retailer, Retailer_name ) as 
Quantity. 




RSUMQ(SUM{SLS_S ALES_F ACT . QU ANTTTY for Retailer. Retailer_name ) 
at Retailer. Retailer_name order by Retailer. Retailer_name asc local) as 
TotaI_Quan:5ty_ 



The aggregated total is now displayed as using running aggregates based on the 
presence of the RSUM function. This setting ensures local processing of the 
summary totals no matter what the output format of the report is. 

7. Click Close. 

8. Change the Rollup Processing property to Extended, and view the generated 
IBM Cognos SQL. 

The SQL appears the same as in the first example because you are explicidy 
asking for an extended aggregate. 

9. Change the Rollup Processing property to Database, and view the generated 
IBM Cognos SQL. 

Again, the RSUM function is present. The Database setting instmcts the IBM 
Cognos query engine to use running aggregates where possible. The Database 
setting pushes the running aggregation to the database using derived tables if 
the database vendor supports this feature. If not, the running aggregation is 
performed locally. 

10. Close Report Studio without saving. 
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Task 3. Examine the Rollup Processing property in 

Framework Manager. 

1. In Framework Manager, in the Project Viewer, expand Data Sources, and 
then click go_data_warehouse. 

In the Properties pane, the value for the Rollup Processing property is set to 
unspecified, rather than a default option. These are the same. Setting Extended, 
Database or Local in the model affects the default behavior for every report 
that is created from it, when the corresponding property in Report Studio is set 
to Default. As seen earlier, you can override the model setting for an individual 
report in Report Studio. 

2. Leave IBM Cognos Connection, and Framework Manager open for the next 
demo. 

Results: 

You demonstrated how to force local processing of summary totals 
by setting the Rollup Processing property in Report Studio. 
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Business Analytics 

Use Filters to Improve Performance 

■ Reducing rows retrieved can improve performance. 

■ You can use: 

■ embedded filters 

■ embedded filters with prompts 

■ encourages users to focus their queries 

■ stand-alone filters 

■ security filters 

Coanos. 

software 
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You can build mandatory filters into the model to ensure that consumers do not 
retrieve excessively large data sets when running reports. 

Is it a requirement that users see all the data all of the time? If not, consider adding 
mandatory filters to the model. 

All filter types (listed above) limit the data set retrieved, resulting in a decreased query 
processing load. 

You should consider filtering data sets when modeling relational data dimensionally. 
This will help offset any decrease in performance from having an additional layer of 
metadata in your model. 
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Business Analytics 

Apply Design Mode Filters 

■ Use design mode filters to improve performance 
when: 

■ testing query subjects in Framework Manager 

■ designing reports in Report Studio and Query 
Studio 



Coanos. 

software 
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Apply design mode filters in query subjects to limit the amount of data that report 
authors and modelers retrieve when testing and designing. 

By limiting data retrieval, design time results appear more quickly. 
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Purpose: 

You want to control how long it takes for queries to run when report 
authors are designing reports in Query Studio and Report Studio. To 
do this you will begin by adding a design mode filter to one of the 
query subjects in our model. 

Components: Framework Manager, Query Studio 

Project: great_outdoors_warehouse 

Package: GO Data Warehouse (query) 

Task 1 . Create a design mode filter. 

1 . In Framework Manager, in the Project Viewer, expand 
go_data_warehouse>Business view. 

2. Open the Query Subject Definition dialog for Sales fact, and then click the 
Filters tab. 

3. Create a filter called Limited Products Design Mode Filter with the 
following expression: 

[Sales and marketing data] . [SLS_SALES_FACT] . [PRODU CT_KEY] in 

( 30001 , 30002 , 30003 , 30004 , 30005 ) 

Hint: The Sales and marketing data namespace is found in the Database view 
namespace. 

4. Click OK to close the Filter Definition dialog box. 

Notice that the current Usage for the filter is set to Always. 
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5. Under the Usage column, click the ellipsis. 

6. In the list, click Design Mode Only, and then click the Test tab. 

7. Click the Options link in the lower right corner, select the Apply all relevant 
design mode filters when testing, and then click OK 

8. Click Test Sample. 




Notice that the test results have the design mode filter applied. The values 
retrieved are restricted to the product key specified in the filter. 

9. Open the Options dialog box, clear the Apply all relevant design mode 
filters when testing, click OK, and then click OK again to close the Query 
Subject Definition dialog box. 

Task 2. Test the design mode filter in Query Studio. 

1. Publish the GO Data Warehouse (query) package and then save the project. 

2. In IBM Cognos Connection, launch Query Studio, and then select the GO 
Data Warehouse (query) package for a query. 
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3. Expand Sales and Marketing (query)>Sales (query), and then add the 



following items to the report: 



Query Subject 


Query Item 


Product 


Product name 


Sales fact 


Revenue 



A list report displaying pages of all products and their revenue appears. 



4. Under Menu, click Run Report, and then click Preview with Limited Data. 

The report appears as shown below: 

limited data 



Product name 


Revenue 


TrailChef Canteen 


11,333,518.65 


TrailChef Cook Set 


41,184,274.9 


TrailChef Cup 


5,702,502.7 


TrailChef Kitchen Kit 


19,535,825.83 


TrailChef Water Bag 


23,057,141.46 


Summary 



The design mode filter is applied and the Sales fact Revenue values are 
restricted to only the products specified in the filter. 

5. Return to IBM Cognos Connection without saving your query. 

Results: 

You added a design mode filter to one of the query subjects in our 
model. Doing this lets you control how long it takes for queries to 
run when a report author is designing a report that uses this query 
subject. 
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Business Analytics 



Reduce Database Connections 

■ Use the same IBM Cognos data source connection 
name: 

■ for all data source connections to the same 
database server instance 



■ to reduce database connections 

■ to prevent local processing 

IBM Cognos Query 



SQL Server 




Cognos. 

software 
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U sing the same data source name for multiple data source connections to the same 
database instance allows for fewer database connections at run time and allows the 
database server to perform the joins between the databases rather than the IBM 
Cognos servers. 

This technique can be implemented in the data source properties in Framework 
Manager. 
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Business Analytics 




= = =■= 


Indicate the Performance Impact of 


Functions 






■ Provide visual clues about the performance of 


functions 






■ Can be set at the project or package level 


Quality of Service Indicators 




X 


Not Available 




II 
■ ■ 


Limited Availability 




1 

■ 


Poor Performance 






Unconstrained 






Coanos. 

software 
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Through a Framework Manager model, report authors can write reports that query any 
combination of data source types, but not all data sources support functions the same 
way. 

The quality of service indicator provides report authors with a visual clue about the 
performance of individual functions when used in conjunction with the data sources 
accessed by the model. This lets report authors avoid using functions that could result 
in long running queries or queries that fail. 

You can also provide descriptive text about a function. 
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Demo 5: Indicate the Performance Impact of Functions 



Purpose: 

Report authors must be aware of the impact of using certain 
functions on the performance of their reports. To help them identify 
potential performance issues with using functions, you will add a 
quality of service indicator to a function that potentially may cause 
performance issues. You will then publish the function (as part of a 
set) with a package. 



Components: 

Project: 

Package: 



Framework Manager, Report Studio 
great_outdoors_warehouse 
GO Data Warehouse (query) 



Task 1 . Define quality of service indicator for a function. 

1. In the Project Viewer, click the GO Data Warehouse (query) package. 

2. From the Actions menu, point to Package, and then click Specify Package 
Function List. 

3. Under Selected function sets, Ctrl+click all items except DB2, and then click 

Remove 

4. Click Define Quality of Service. 
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7 . 

8 . 



Expand the Business Date/Time Functions folder, from the indicator list, 
next to the f(x) _day_of_year function, click the down arrow, and then click 

Limited Support. 



The results appear as follows: 



Modify the quality of service using the tree b 



+ 

0 

0 

+ 



Summaries 
Member Summaries 
Constants 
Constructs 

ZB Business Date/Time Functio 



✓ 



✓ 



✓ 



✓ 



✓ 



✓ 



■Afix) _add_days 
Aft*) _add_months 
jaddjears 
_age 

Affix} _day_of_week 
Affix) _day_of_year 

Affix} _days_between 



Click in the box next to the list of functions, and then type This function may 
adversely affect performance if used against non-filtered data sets. 

This information becomes available to your report authors and can assist them 
in determining whether to use this function in their reports. 

Click OK, and then click OK again. 

Save the project. 



Task 2. Publish the package and test the quality of service 

indicator. 



1 . Publish the GO Data Warehouse (query) package. 
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2 . 

3. 

4. 

5. 

6 . 

7. 

8 . 



In IBM Cognos Connection, launch Report Studio selecting the GO Data 
Warehouse (query) package, and then create a List report. 

Expand Sales and Marketing (query) > Sales (query) >Time dimension. 

Drag the Date item to the report. 

In the report, double-click the Date column. 




Under the Available Components pane, click the Functions I tab. 
Expand the Business Date/Time Functions folder. 

Notice the Limited Support E indicator within the /(xj_day_of_year function. 



Click the f(x) LLl_day_of_year function. 



The results appear as follows: 



J I V _uut. 



_day_of_year 



j ft) _day_of_week 

Ml 

ffV _days_between 
jfty _days_tQ_end_of_month 
M _first_of_month 
jfiO Jast_Qf_month 
^ _make_timestannp 
jft) months between 



Q Information: X 




_day_of_year [ dateexp ) 

Returns the ordinal for the day of the year in 

Yta+p pyn T ( 1 t n TEfiY Ak n IcnniA'n ;=n liilisn Hsv. 




This function may adversely affect performance if 
used against non-filtered data sets 









In the Information pane, notice the text that you added as additional 
information about the function earlier. 



9. Click Cancel, and then close Report Studio without saving. 

10. Close Internet Explorer, and then, in Framework Manager, save and close 
your project. 

Results: 

You added a quality of service indicator to a function and published 
a package that contains it. Report authors will be aware of the 
impact of using this function on the performance of their reports. 
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Business Analytics 

Summary 

■ You should now be able to: 

■ Identify and implement techniques to optimize and 
tune your Framework Manager models 



Coanos. 

software 
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Work in a Multi-Modeler 

Environment 

IBM Cognos BI 




Business Analytics 
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Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ implement repository control 

■ segment and link a project 

■ branch a project and merge results 








Cognos* 

software 
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Business Analytics =§==:= 7 §: 

Use Repository Control 

■ Use a repository control system of your choice on 
Framework Manager project files to: 

■ manage and backup versions of you project 

■ prevent change conflict between users by checking 
files in and out 

■ ensure modelers are always working on the latest 
version 

Cognos. 

software 
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You can manage Framework Manager projects with an external source control system. 
Please refer to the documentation on how to put the Framework Manager project files 
into an external repository. 
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Framework Manager Projects consist of three essential files, plus a log file directory. 
These files are: 



File Name 


Optional/Required 


Description 


[Project namej.cpf 


Required 


This project file tracks segments and links. 


model .xml 


Required 


This is the model data. 


customdata.xml 


Required 


This saves user interface information such as 
diagram layout. 


preferences. xml 


Optional 


This file is not used. 


repository.xml 


This file must not be present if you are handling your own repository. If 
this file is in your project, you must delete it. 



X 


Name ^ 


Size 


Type 


Date Modified Att 


- godatawarehouse A 

Ir^i leas 


Ir^loas 

^customdata.xml 


90 KB 


Hie Folder 
XML Document 


5/5/2005 4:37 PM 
10/4/2004 2:57 PM A 


+ j gdsalesjgoretailers 


HHl go_data_warehouse . cpf 


2KB 


BMT Project Rle 


5/9/2005 3:59 PM A 


+ 3 junk 


= model, xml 


2,014 KB 


XML Document 


5/9/2005 3:59 PM A 


+ ^ LineageDiagram 


^Preferences, xml 


1KB 


XML Document 


6/7/2004 11:38 AM A 



Log files are found in the "logs" subdirectory. A new log file is created each for each 
Framework Manager session. These logs are required only if you intend to use the 
Model Synchronization feature. External repository handling is simpler if you ignore 
the log files. 



X 


Name 


Size 


Type 


Date Modified 


At 


2) godatawarehouse * 


'W!\ go_data_warehou5e-2QQ4100 5 10 5202-log . xml 


13 KB 


XML Document 


10/5/2004 11:01 AM 


A 




="] go_data_warehouse-20041005 1 1 1445-log . xml 


2KB 


XML Document 


10/5/2004 11: 16 AM 


A 


+ 2) qosales qoretailers 


'= go_data_warehouse-20050 50915 5417-log . xml 


11® 


XML Document 


5/9/2005 3:59 PM 


A 


+ 2) junk, 


=^| go_data_warehouse-20050 509 1623 174og . xml 


1KB 


XML Document 


5/9/2005 4:23 PM 


A 


+ 2) LineageDiagram 


=^| go_data_warehouse-2QQ 50 509 163719-log . xml 


1KB 


XML Document 


5/9/2005 4:37 PM 


A 


l+ £2) link 


="] go_data_warehouse-2QQ 50 509 164739-log . xml 


If® 


XML Document 


5/9/2005 4:47 PM 


A 
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1. After your Framework Manager project is created, make sure it is closed, and 
then, 'Check In' the project file.cpf, model.xml, and customdata.xml into your 
repository of choice. 

2. Before opening the Framework Manager project to begin modeling again, you 
will be required to 'Check Out' those three files out from your repository. 

NOTE: If you fail to do so (and your repository system marks checked in files 
as read-only), Framework Manager will open in read-only mode. The 
text "[Read Only]" will appear on the application title. 

SOLUTION: If this happens, close the project, and check out the files. If 
you have done a lot of work in a read-only project, then you may save 
the project, and you must then ensure those files get checked in 
properly. 

3. When your Framework Manager session is complete, close the project, and 
then 'Check In' these three files to your repository. 
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Business Analytics =§==:= 7 

Create a Segment 

■ Creates a new project with its own project files 

■ Use segments to: 

■ distribute a project according to business rules and 
organizational requirements 

■ share and re-use project information with other 
projects 



Cognos. 

software 
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When you create a segment, you create a new project in a new folder, complete with its 
own associated project files. The new project is linked by a shortcut in the main project 
from which it was created. 

You can only segment a project either at the folder or namespace level. 

The master project has access to the entire model, including the segments. 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



22-7 



IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Business Analytics 



Segmenting/Linking Example 



Master Project 

(Modeler 1) 



HR Project Segment 




Modeler 1 can create segments for the HR and Marketing metadata. These segments 
are new projects created by Framework Manager and become links in the master 
project. 

Modeler 2 will work on the HR metadata, to model for predictable results, while 
modeler 3 will work on the Marketing metadata. The changes they make will be 
reflected in the master project. 

Communication is required between the modelers to ensure that no one overwrites 
each others changes. For example, modeler 1 should not make any changes to the HR 
or Marketing metadata without talking to the respective segment owner otherwise 
modeling conflicts might occur and changes may be lost. 

The HR and Marketing segments can also be linked into other projects that may 
require this type of information. 
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Regarding repository control: 

For segmented projects, the segments are simply project directories stored under the 
parent project directory. There are two ways to work with a segmented project. 

1. The segments can be individually opened as stand-alone projects, in which case 
repository handling is the same as for any other project. 

2. Or segments can be opened as part of the main project. In this case you have 
to 'Check Out' the projects for each segment you intend to modify, which are 
located, as sub-directories under the main project. 

NOTE: The repository should maintain the same hierarchy as the project directory. 

If you do require the Model Synchronization feature, you must 'Check In' any new log 
files that are created. When you are ready to synchronize, you will need to get a copy of 
all the project log files. 

NOTE: It is not necessary to 'Check Out' the log files, as they are never updated after 
they are first created. 
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Demo 1 : Create a Segment 



Purpose: 

You want to distribute the workload of a project to another modeler. 
You want the other modeler to work on employee related data, while 
you work on other business areas. 



Component: Framework Manager 



Project: 



New Project 



Task 1 . Create a project. 

1. In Framework Manager, close any open projects, and then create a new 
project. 

2. In the Location box, navigate to C:\Edcognos\B5152\Course_Project 

3. In the Project name box, type great_outdoors_warehouse_MASTER and 

then click OK 

4. On the Select a Language dialog, ensure English is selected, and then click 

OK. 

5. Ensure Data Sources is selected, and then click Next. 

6. Click great_outdoors_warehouse, and then click Next. 

7. Expand GOSALESDW>Tables, and then select all tables prefixed with EMP 

and SLS. 

Tip: You can select the first EMP_ table, scroll down to the last EMP_ table, 
and then Shift+click the last EMP_ table to select them all. Then repeat 
for the SLS_ tables. 

8. Click Next, Import, and then Finish. 

You will rename the root namespace and organize the imported objects. 
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9. Rename the root namespace to Great Outdoors Warehouse. 

10. Create an empty folder in the Great Outdoors Warehouse namespace called 

Data Source View. 



1 1 . Create a namespace in the Data Source View folder called gosalesdw. 

12. In the Great Outdoors Warehouse root namespace, select all query subjects 
and drag them into the gosalesdw namespace. 

The results appear as follows: 






+ 

0 

\±\ 

El 

El 

+ 












great_outdoors_warehouse_MAS TER 

Great Outdoors Warehouse 
- ^ Data Source View 
gosalesdw 

EMPEMPLOYEEDIM 
EMF'_EXPENSEJFACT 
EM F'_EXP ENS E_P LAN_F ACT 
EM F'_EXP ENS E_TYP E_D I M 
EMPEXPENSEUNITLOOKUP 
EM P_P0S ITIO N_DI M 
EMP_P0SITI0N_LJ00KUP 
EM P_P0S ITIO N_S U M MARY_FACT 
EMP_RANKING_DIM 
EMP_RANKING_FACT 
EM P_R EC R U ITM ENT JD! M 
EM F'_R EC R U ITM ENT_F ACT 
EMP_SUCCESSION_FACT 
EM F'_S UCC ESS 10 N_STAT US_D I M 
EM P_S U M M AR Y_FACT 
EM F'_S U R VE Y_F ACT 
EM P_S U R VEY_TARG_F ACT 
EM P_S U RVEY_T0 P IC_D I M 
EMP_TERMINATI0N_U00KUP 
EMP_TRAJNING_DIM 
EMP_TRAINING_FACT 

S LS_P RO D UCT_B RAND_L00KUP 
BB ' - ~ - - - " - - - - - 









+ 

El 

El 

El 

El 

El 

+ 










13. Save the project. 
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Task 2. Create a folder containing objects you would like to 

segment. 

1 . In the Project Viewer, in the gosalesdw namespace, select all data source 
query subjects prefixed with EMP. 

You will create a new parent folder for the selected objects. 

2. Right-click one of the selected query subjects, point to New Parent, and then 
click Folder. 



3. 

4. 



The employee data source query subjects are now contained in the new folder 
Rename New Folder to Employee Info. 

Expand the folder to view the objects inside. 

The results appear as shown below: 












- Data Source View 
gosalesdw 

S LS_P RO D UCTJ3 RAND_LDOKUP 
SLSPR0D UCT_CO LO R_LOO K U P 
S LS_P RO D UCT_D I M 
S LS_P RO D UCTJJN E_UDO KU P 

SLS_PRODUCT_LDOKUP 

S LS_P RO D UCT_S IZE_UDOKUP 
S LS_P RO D UCT_TYP E_LJOO KU P 
S LS_RTL_D I M 
SLS_5ALES_FACT 
S LS_S ALES_0 R D ER_D I M 
S LS_S ALES_TARG_F ACT 
0- Employee Info 

EMP_EMPLJOYEE_DIM 
EMP_EXPENSE_FACT 
EM P_EXP ENS E_P LAN _F ACT 
EM P_EXP ENS E_TYP E_D I M 
EM P_EXP ENS E_U N IT_LOO KU P 
EMP_P0SITI0N_D1M 
EMP POSITION LOOKUP 












5. Save the project. 
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Task 3. Create a segment and view project files. 



1 . 

2 . 



3. 



Right-click the Employee Info folder, and click Create Segment. 
Accept the defaults and click OK. 

The Employee Info folder is now represented by a link icon 

Open Windows Explorer and navigate to C:\Edcognos\B5152\ 
Course_Project\great_outdoors_warehouse_MASTER. 

The results appear as follows: 




^Employee Info 
= , archive-log .xml 
i^jcustomdata.xml 

great_outdoors_warehouse_M ASTER . cpf 
^IDLog.xml 
y log .xml 
= i model .xml 
= , Preferences .xml 
= , session-log .xml 



'= session4og-ba(±up.xml 



Notice the Employee Info folder. 

4. Open the Employee Info folder. 

Notice a new set of Framework Manager project files. Now the second modeler 
can work on this separate project and have the changes reflected in the main 
project. 

Task 4. Make changes in the segmented project. 



1 . Return to Framework Manager, and then close the 
great_outdoors_warehouse_MASTER project and click Yes to save the 
changes. 

2. Open the Employee Info project. 

3. In the middle pane, click Diagram. 
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4. In the Project Viewer, expand gosalesdw> Employee Info. 

5. Right-click EMP_TERMINATION_LOOKUP, and then click Locate in 
Diagram. 

6. Modify cardinality of the relationship as follows: 

EMP_TERMINATION_LOOKUP (TERMINATION_CODE, 1..1) to 
EMP_EMPLOYEE_DIM (TERMINATION_CODE, 1..1) 

7. Change the Usage property for TERMINATION_CODE in 
EMP_EMPLOYEE_DIM to Attribute. 

8. Save and close the project. 

Task 5. View changes in main project. 

1. Open the great_outdoors_warehouse_MASTER project. 

2. In the Project Viewer, locate and expand the EMP_EMPLOYEE_DIM 
query subject in the linked Employee Info segment. 

Notice that TERMINATION_CODE is now set as an attribute. 

3. Open EMP_TERMINATION_LOOKUP in the Context Explorer and 
select Show Related Objects. 

Notice the relationship to EMP_EMPLOYEE_DIM. All the changes made in 
the segment project are reflected in the main project. 

4. Close the Context Explorer, and then close the project. 

Results: 

You distributed the workload of a project to another modeler by 
creating a segment. Changes made to the segment were reflected in 
the main project. 
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Business Analytics 


= == ==== 


Create a Link 




■ Create links to existing projects to: 




■ organize work across large projects 




■ maintain consistency 




■ re-use information 




■ You can only create links to: 




■ folders 




■ namespaces 




■ projects 
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A link is a shortcut to an existing project, folder, or namespace. 

You must create the project, folder or namespace before you can link to it. 
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Purpose: 

You will create a new project that will model the marketing metadata 
of the Great Outdoors Company. This project can also be leveraged 
in the great_outdoors_warehouse_MASTER project, so you will 
create a link to it. 



Component: Framework Manager 



Project: 



New Project 



Task 1 . Create a New Project for marketing information. 

1. In Framework Manager, create a new project in the Course_Project folder. 

2. Name the project Marketing Info, and then click OK 

3. If a message displays regarding the structure of the project, click OK 

4. Click OK, click Next twice, and then import all tables prefixed with MRK 
located in the GOSALESDW schema from the great_outdoors_warehouse 
data source. 

You need to create the same namespace parent in this project as in the main 
great_outdoors_warehouse_MASTER project to link in the marketing 
metadata. 

5. Rename the root namespace great_outdoors_warehouse. 

6. In the Project Viewer, under the great_outdoors_warehouse namespace, 
create a folder called Data Source View, and then under that, create a 
namespace called gosalesdw. 
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7. Under the gosalesdw namespace, create a folder called Marketing Info, and 
then move all the marketing query subjects into the new folder. 

The results appear as shown below: 



Project Viewer 



n x 



□■■is Marketing Info 

[=]■■■ [H] great_outdoors_warehouse 
Fl-Pfr Data Source View 
□-[HI gosalesdw 

□■• B Marketing Info 



El- 

El- 

El- 

El- 

El- 

El- 

El- 

El- 

El- 

El- 

El- 

El- 



M FI K. ACT I VI TY_S TAT U S_D I M 
MRK_BUNDLE_GROUP_LOOKUP 
MRK_CAMPAIGN_LOOKUP 
M FI K_PR 0 D U CT_S U R VE Y_D I M 
M FI K_PR 0 D U CT_S U R VE Y_FACT 
M FI K_PR 0 D_S U RVE Y_T AR G_FACT 
M Fl K_PR 0 M 0 T 1 0 N_D I M 
MRK_PR0M0TI0N_FACT 
M FI K_PR 0 M □ T 1 0 N_PLAN_FACT 
MRK_RTL_SURVEY_DIM 
M R K_R T L_S U R VE Y_FACT 
MFlK RTL SURVEY TARG FACT 



8. Save and close the project. 

Task 2. Create a link in the main project. 

1 . Open the great_outdoors_warehouse_MASTER project. 

2. Right-click the gosalesdw namespace, and then click Link Segment. 

3. If a message appears regarding the structure of the project, click Yes. 

4. Browse to the Marketing Info.cpf file, and then click Open. 

5. Click OK to the UNC recommendation message, expand 

great_outdoors_warehouse>Data Source View>gosalesdw, and then click 
the Marketing Info folder. 

6. Click Add, and then click OK 
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7. Expand gosalesdw and Marketing Info. 



The Marketing Info project is now linked in the 
great_outdoors_warehouse_MASTER project as shown below: 



+ 

0 

0 

+ 






a 

D 






S LS_S ALES_FACT 
SLS_SALES_ORDER_DIM 
S LS_S ALES _TARG_ FACT 
Employee Info 
Marketing Info 

M R K_ACTI VITY_ST AT US_DIM 
M R K_B U N D LE_G RO U P_LJOO KU P 
MRKCAMPAJGNLOOKUF 
M R KJP RO D UCT_S U RVEY_DI M 
M R KJP RO D UCT_S U RVEY_FACT 
M R KJP RO D_S U R' VEY_TARG_F ACT 
M R KjP RO MOTIO N_D I M 
M R K jP RO MOTION_FACT 
M R KjP RO MOTIO N_P LAN_FACT 
MRK_RTL_S URVEYDIM 
M R K_RTL_S U RVEY_FACT 
MRK RTL SURVEY TARG FACT 












8. Save the project and leave it open for the next demo. 

Results: 

You successfully linked the Marketing Info project in the 
great_outdoors_warehouse_MASTER project. 
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Business Analytics 



Consolidate Linked Segments 



■ Consolidate linked segments in a project by publishing 
a package to a network location 

Project with Links Consolidated Project 







Metadata 


Metadata 






Linked Metadata 






Linked Metadata 




Publish to 
Network 







Metadata 


Metadata 






Metadata 






Metadata 
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The new package published to the network will include all the metadata specified by the 
modeler without any linked segments. 

This process is useful when a multi-modeler environment is no longer required and you 
wish to consolidate your metadata into one project. This process is also useful if you 
would like assistance troubleshooting your model from support or other modelers. 
Rather than sending the master project and all the linked projects, you can send one 
consolidated model. 
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Purpose: 

You would like to consolidate your multi-modeler environment by 
creating a single project that contains all the metadata without links 
to other projects. 

Component: Framework Manager 

Proj ect: great_outdoors_warehouse_MASTER 

Task 1. Publish a package to the network. 

1 . In the Project Viewer, create a new package called 

great_outdoors_warehouse_FINAL. 

2. Accept the defaults and click Finish. 

3. Click Yes to start the Publish Package Wizard. 

4. Select Location on the network, and then browse to 
C:\Edcognos\B5152\Course_Project. 

5. Create a new folder called great_outdoors_warehouse_FINAL, select it, and 
then click OK 

6. Click Next, click Next again, and then click Publish. 

7. Click Finish, and then save and close the project. 
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Task 2. Examine the consolidated project. 








1. Open the great_outdoors_warehouse_FINAL project. 

2. Expand Great Outdoors Warehouse>Data Source View>gosalesdw. 

Project Viewer I 

greatoutdoorswanehouseMAS TER 

Great Outdoors Warehouse 
Data Source View 
gosalesdw 

SLS_P RO D UCT_B RAN D_UDO KU P 
SLS_P RO D UCTCOI LO R_IDO KU P 
SLS_P RO D UCT_D1 M 
SLSP RO D UCT_LI N E_LDO KU P 
S LS_P RO D UCT_LDO KU P 
S LS_P RO D UCT_S IZE_LDO KU P 
S LS_P RO D UCT_TYP E_LDO KU P 
SLS_RTL_DIM 
SLS_SALES_FACT 
SLS_SALES_ORDER_D!M 
SLS_SALES_TARG_FACT 
n Employee Info 
n Marketing Info 












Notice that the Employee Info and Marketing Info folders are no longer links. 
All metadata is now contained within this one project. 



Also notice that the project maintains the original project name, 
great_outdoors_warehouse_MASTER. However the .cpf name is identified in 
the title bar, great_outdoors_warehouse_FINAL. To avoid confusion, it is 
recommended to rename the project to match the .cpf file. 



3. Rename the project to great_outdoors_warehouse_FINAL, and then save 
the project. 

Results: 

By publishing the entire great_outdoors_warehouse_MASTER 
project to the network, you consolidated all linked metadata into one 
project. 
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Business Analytics 

Branch a Model 

■ Enables parallel modeling 

■ creates a copy of the project for simultaneous 
development on any portion of the model 

■ Unlimited branches 

■ Merge changes (bi-directional) 



Root Project 




Branch Project 


Metadata 




Altered Metadata 


Altered Metadata 


^ Merge r 
Changes 


Metadata 
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Unlike segmenting and linking, which allows for modelers to work on individual 
segments of a model independently, branching and merging allows multiple modelers 
to work on the same model in its entirety at the same time. They are not limited to just 
one segment and can make changes to any portion of the model. To do this, the project 
owner makes a copy of the root project, called a branch. A team member can modify 
the branch as required, independendy of the root project. Branches can be merged back 
into the root project or from the root project into the branch as required. 

Conflicts between the root project and a branch are resolved during the merge process. 

Project branching is compatible with segmenting and linking. 

Modelers should be in constant communication to ensure their modeling actions will 
not affect other branches or the root project. 
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Purpose: 

You would like to allow another modeler to work on your model at 
the same time as you. Use the project branching feature in 
Framework Manager to allow a second modeler to work on a branch 
of your project, and then merge the changes with your root project. 

Component: Framework Manager 

Pro) ect: great_outdoors_warehouse_FINAL 

Task 1 . Create a Branch of the root model. 

This task is completed as modeler 1 . 

1 . If it is not already open, open the great_outdoors_warehouse_FINAL 
project. 

2. From the Project menu, click Branch to. 

3. Change the branch project name to great_outdoors_warehouse_FINAL 
Branch 1, and then click OK 

4. Save and then close the great_outdoors_warehouse_FINAL project. 

Task 2. Modify the branch model. 

This task is completed as modeler 2. 

1 . Open the great_outdoors_warehouse_FINAL Branch 1 model. 

2. Expand Great Outdoors Warehouse>Data Source View> 
gosalesdw> SLS_PRODU CT_DIM. 
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3. Change the properties for the following items from Fact to Attribute: 

• PRODU CT_TYPE_KEY 

• PRODU CT_NUMBER 

• BASE_PRODUCT_ KEY 

• B ASE_PRODU CT_NUMBER 

• product_brand_key 

4. Right-click SLS_RTL_DIM, click Launch Context Explorer and then select 
Show Related Objects. 

5. Double-click the relationship between SLS_RTL_DIM and 
SLS_S ALE S_F ACT . 

6. Change the cardinality for SLS_SALES_FACT to 0..n. 

7. Close the Relationship Definition dialog box and the Context Explorer. 

8. Save and close the project. 

Task 3. Merge the branch into the root project. 

This task is performed as modeler 1 . 

1 . Open the great_outdoors_warehouse_FINAL model. 

2. From the Project menu, select Merge from. 
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3. Navigate to the great_outdoors_warehouse_FINAL Branch l.cpf and click 
Open. 

The results appear as follows: 




You are presented with a transaction list. You have the option to clear check 
boxes for transactions that you do not want updated in the root model. In your 
case you will accept all the changes. You can also choose to step through each 
transaction and then pause, or simply mn all transactions. 
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4. Click Run. 

All transactions are successfully merged into the root project. A backup project 
is created on the file system in the same location as the root project with a data 
timestamp. This allows you to revert back to the previous version if required. 

After the branch project is merged, it will still exist on the file system. If it is no 
longer required, it is recommended that you delete the branch project after it is 
merged into the root project. New branches can be created as required. 

5. Click Accept, view the same objects in the root project, and note the changes 
merged in from the branch project. 

6. Save and close the project, and then close Framework Manager. 

Results: 

Using the project branching feature in Framework Manager, you 
were able to apply changes in a branched project and then merge 
those changes into the root project. 
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Business Analytics 

Summary 

■ You should now be able to: 

■ implement repository control 

■ segment and link a project 

■ branch a project and merge results 
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Business Analytics =^==^?§: 

Objectives 

■ At the end of this module, you should be able to: 

■ connect to an OLAP data source (cube) in a 
Framework Manager project 

■ publish an OLAP model 

■ publish a model with multiple OLAP data sources 

■ publish a model with an OLAP data source and a 
relational data source 

Cognos e 

software 
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Business Analytics 

OLAP Data Sources in IBM Cognos 



■ IBM Cognos Business Intelligence provides full 
support for the analysis of PowerCubes and other 
OLAP data sources. 



Revenue 


2004 


2005 


2006 


Years 


Camping Equipment 


$20,471,328.88 


$31,373,606.46 


$37,869,055.58 


$89,713,990.92 


Golf Equipment 


$5,597,980.86 


$9,598,268.83 


$10,709,215,84 


$25,905,465.58 


Mountaineering Equipment 


$0.00 


$9,642,674,54 


$11,248,676,06 


$20,891,350.60 


Outdoor Protection 


$1,536,456.24 


$988,230.64 


$646,428.04 


$3,171,114.92 


Personal Accessories 


$7,144,797.52 


$10,955,708.04 


$13,793,960.30 


$31,894,465.86 


Products 


$34,750,563.50 


$62,558,488.56 


$74,267,335.82 


$171,576,387.88 
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Other OLAP sources include: 

• IBM Cognos Planning Analyst Models 

• Microsoft Analysis Services 

• IBM DB2 OLAP 

• Hyperion Essbase 
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Business Analytics =^==^?§: 

Connect to and Publish OLAP Data 
Sources 

■ Use Framework Manager or IBM Cognos Connection 
to connect to an OLAP data source. 

■ Cubes are published directly to the portal, without any 
modeling required. 

■ Use Framework Manager to: 

■ create multi-cube packages 

■ combine cubes and relational metadata in one 
package 

Cognos^ 

software 

©2010 IBM Corporation 



You can use Framework Manager or IBM Cognos Connection to create data source 
connections to various cube data sources. When you import a cube into Framework 
Manager, no modeling is required since the modeling has already been done in an 
OLAP modeling tool such as IBM Cognos Transformer. 

The package is then published directly to the portal, making it available to report 
authors. 

Not only can you publish IBM Cognos PowerCubes from Framework Manager, you 
can also publish them directly in IBM Cognos Connection or from IBM Cognos 
Transformer. 
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Demo 1: Import and Publish an OLAP Data Source 



Purpose: 

Authors would like to be able to report from data stored in multiple 
OLAP sources. You will initially create a Framework Manager project 
and import a PowerCube. 



Components: Framework Manager, Analysis Studio 

Project: OLAP_Model 

Package: GOCube 

Task 1 . Create a new project and import a cube. 

1. In Framework Manager, close any projects that may be open, from the File 
menu, click New, and then name the new project OLAP_Model. 

2. Set the Location to C: \Edcognos \B5152\ Course_Pro j ect\ OLAP_Model, 

and then click OK. 

3. In the Select Languages dialog box, ensure that English is selected, and then 
click OK. 

4. In the Metadata Wizard window, ensure that Data Sources is selected, and 
then click Next. 

5. Click New, click Next, in the Name box, type GOCube, and then click Next. 

6. Under Type, select IBM Cognos PowerCube, and then click Next. 

The connectivity information you supply for a cube data source connection will 
depend on the type of cube source you are accessing. For example, 

PowerCubes require that you supply the filename and path for the cube. 

To specify the location, you will use Windows Explorer to obtain the path and 
file name since the cube is local. For a network cube, use a UNC path. 
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7. Open Windows Explorer and navigate to D:\Program Files\ 
IBM\cognos\clO\webcontent\samples\datasources\cubes\ 
PowerCubes\EN. 

Notice that there is a cube named great_outdoors_sales_en.mdc. 

8. Copy the path from the Address box to the Windows location box in the 
New Data Source Wizard, and then type \. 

9. Copy the name of the PowerCube (including file extension) to the Windows 
location box (after the \) in the New Data Source Wizard. 

10. Scroll down, under Testing, click Test the connection, and then click Test. 
A message appears indicating that the test was successful. 

1 1 . Click Close, and then click Close again. 

12. Click Finish, and then click Close. 

13. In the list of data sources, click GOCube, click Next and then click Finish 
twice. 

You are now prompted to create a package for this project. You will use the 
name GOCube for your package. 

14. Click No, and then save the project. 
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Task 2. Examine objects and publish a package. 

1. In the Project Viewer pane, expand Model, and then expand Packages. 
The results appear as follows: 



Project Viewer 


- H OLAF 

EEl-fH] Mo 

i 1 m 

[q] Da 

$ •© Pai 
-]• © Pai 


_Model 

del 

GOCube 
ta Sources 
■ameter Maps 
^kages 
GOCube 



You can see that the GOCube model does not include any additional 
information. Everything needed to publish it is stored internally in the data 
source. You could have created your connection to the cube and your package 
entirely in IBM Cognos Connection, but you are doing it here so that you can 
later add additional cubes to the model. 

2. Under Packages, right-click GOCube, and then click Publish Packages. 

3. Clear the Enable model versioning check box, click Next twice, click 
Publish, and then, click Finish. 

4. Save your project. 
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Task 3. Test the GOCube cube. 

1 . Launch IBM Cognos Connection, log in, and then launch Analysis Studio 

selecting the GOCube package. 

2. Select Default Analysis, and then click OK 
The results appear as follows: 




You have successfully published an IBM Cognos PowerCube, which can be 
used to analyze data and write reports in IBM Cognos. 

3. Close Analysis Studio without saving the analysis. 

4. Leave IBM Cognos Connection and Framework Manager open for the next 
demo. 

Results: 

You created a new Framework Manager project, connected to a 
PowerCube, and created a data source connection and package. 
You then published the package and tested it in Analysis Studio. 
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Demo 2: Import and Publish Multiple OLAP Data Sources 



Purpose: 

Authors would like to access financial data stored in a Microsoft 
Analysis Services cube. They would also like to be able to link data 
from this cube to the original Great Outdoors Company PowerCube. 
You will add this second cube to your model and then create a test 
report. 



Components: Framework Manager, Analysis Studio 

Project: OLAP_Model 

Package: GOCube 

Task 1 . Add the sales_and_marketing cube to the model. 

1 . In Framework Manager, in the Project Viewer pane, right-click Model, and 
then click Run Metadata Wizard. 

2. In the Metadata Wizard window, ensure that Data Sources is selected, and 
then click Next. 

3. In the Metadata Wizard window, click sales_and_marketing, and then click 
Next. 

4. Click Finish to complete the wizard. 

5. Click Finish to create the sales_and_marketing package. 
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6. Click No when asked if you want to Open the Publish Package Wizard. 

The results appear as follows: 



Project Viewer 



□ X 



OLAP Model 



□ Sfi 

EE]- l^jjl Model 



/ GO Cube 



sales_and_marketing 



0 - 

a- 



Data Sources 
Parameter Maps 
Packages 
GO Cube 

sales_and_marketing 



Task 2. Add the sales_and_marketing package to the GOCube 

package and publish. 

1 . In the Project Viewer, under Packages, double-click GOCube. 

2. Select sales_and_marketing, and then click OK 

3. Publish the GOCube package. 

Task 3. Create a report with the GOCube package. 

1 . In IBM Cognos Connection, launch Report Studio selecting the GOCube 

package. 

2. Create a new List report. 

3. In the Insertable Objects pane, under GOCube, expand both GOCube and 
sales_and_marketing. 

The dimensions for each cube appear. You will now create a report that 
displays data from both cubes. 

4. Expand GOCube>Products>Products, and then drag the Product line level 
to the report. 

5. Expand Measures, and then drag the Revenue to the report. 
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& 



tab, and then drag a 



In the Insertable Objects pane, click the Toolbox 

List object to the right of the list in the report, so that the list is added as a new 
column. 



The results appear as follows: 



a j 

J Product line 


Revenue 


List 


< Product 
line> 


-=: Revenue:- 


* j 
a 














Drop terns here to create new columns 





7. On the Source tab, expand the sales_and_marketing cube. 

8. Expand Products>Products, and then drag the Product line level to the 
report. 

9. Expand Measures, and then drag Gross Margin and Revenue to the report. 
The results appear as follows: 



= To duct line Revenue List 



< Product line> 


< Reven ue> 


a a 

Product line 


Gross margin 


Revenue 






< Pro duct line> 


< Gross margin> 


< Revenue* 






< Pro duct Jine> 


< Gross margin> 


< Reven ue> 






< Pro duct lines- 


< Gross margin> 


Revenue:- 
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10. On the toolbar, click Run Report 



► 



The results appear as follows: 



Product line 


Revenue 


List 


Camping Equipment 


1,509,036,664.03 




Product line 


Gross rmargin 


Revenue 






Camping Equipment 


21.3% 


1,539,036,664.03 






Golf Equipment 


43.6% 


726,411,367.39 






Outdoor Protection 


93.1% 


75,994,296.25 






Pers o n a 1 Access o ries 


14.9% 


1 ,335,673,307.73 






Mountaineering Equipment 


24.3% 


409,660,132.90 


Golf Equipment 


726,411,367.89 




Product line 


Gross margin 


Revenue 






Camping Equipment 


21.3% 


1,539,036,664.03 






Golf Equipment 


43.6% 


726,411,367.39 






Outdoor Protection 


93.1% 


75,994,296.25 






Pers o n a 1 Access o ries 


14.9% 


1,335,673,307.73 






M o u nta Sneer n g Eq u ip merit 


24.3% 


409,660,132.90 



The report opens in Cognos Viewer. Gross Margin and Revenue is repeated for 
each Product line. You need to link the two list reports on Product line. 
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Task 4. Create a master-detail link. 

1 . Close Cognos Viewer. 

2. In the inner list, click Product line, and then, from the Data menu, click 

Master Detail Relationships. 

3. Click New Link. 

The results appear as follows: 




A link appears between the first column of each query (between Product line 
and Product line) . This is the link that you want to create, so you do not have to 
modify it. 

4. Click OK, and then run the report. 

The results appear as follows: 



Product line 


Revenue 


Let 


Camming Equipment 


1,589,036,664.03 


Product line Gross marg in Revenue 






Camping Equip men: 21.3% 1,569,036,664.03 


Golf Equipment 


726,41 1 ,367.69 


Product line Gross margin Revenue 






Golf Equipment 46.6% 726,411,367.69 


Mountaineering Equipment 


409,660,132.90 


Product line Gross marg in Revenue 






Mountaineering Equipment 24.3% 409,663,1 32:90 



The margin and revenue data for each Product line appears in the proper rows. 
You have left the Product line column in the report for verification, but you 
would remove it from the report layout for the production report. 
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5. Close Cognos Viewer, and then close Report Studio without saving the 
report. 

6. Close IBM Cognos Connection, and then close Framework Manager, without 
saving the changes. 

Results: 

You added an additional cube to your existing model and package. 
You then published the package and created a report that linked 
data from the new cube to the original cube. 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



23-15 







IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Business Analytics 

Summary 

■ At the end of this module, you should be able to: 

■ connect to an OLAP data source (cube) in a 
Framework Manager project 

■ publish an OLAP model 

■ publish a model with multiple OLAP data sources 

■ publish a model with an OLAP data source and a 
relational data source 



Cognos, 

software 
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Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ specify package languages and function sets 

■ control model versioning 

■ nest packages 





Coanos. 

software 
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Business Analytics S==^.~== 

What is a Framework Manager 
Package? 

■ A subset of the project metadata to be published to 
IBM Cognos Connection 

■ You can: 

■ create different packages to meet different 
requirements 

■ apply security to packages to restrict access 

■ include other packages in a package (nesting) 

Cognos. 

software 
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Each package can contain a different set of folders, filters, query subjects, and query 
items. You can customize its contents to satisfy different reporting requirements and to 
set up a logical presentation of the metadata. 

Nesting packages can save development and maintenance time. 
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Business Analytics ==^i¥ 

Create and Modify Packages 

■ Include the model objects you want to publish in your 
package. 



Model 




Package 



AT 


7 




7 
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At any time, you may go back and edit the definition of your package by adding or 
removing objects. You must exercise caution when doing this as you may break reports 
based on a previous version of the model. 
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When you create a package, you can choose whether objects from the model will be 
included, excluded, or hidden, based on the requirements of reports authors. These 
three options are described as follows: 

• Select - the object and its child objects can be used in reports by report authors 

• Hide - the object and its child objects cannot be used by report authors, but 
objects available to report authors that reference the hidden objects can. With 
this option, you will not receive informational messages when publishing your 
package stating that underlying objects will be published because other objects in 
the package reference them. 

• Unselect - the object and its child objects are not published. It cannot be used for 
reports and cannot be selected by report authors. If other objects in the package 
reference the unselected object, the object will be included and hidden in the 
package and you will receive informational messages stating this. 
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Business Analytics 

Languages and Function Sets 

■ Specify which languages are to be included in a 
package. 

■ Each language added will add additional metadata 
that has been translated. 

■ Specify which function sets to include in a package. 

■ Add vendor specific function sets to match the data 
sources used in a package. 



Cognos* 

software 
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In the case where you have modeled for a multilingual audience, you can specify the 
languages to be published with a package. You must add languages to the project 
before you can add them to a package, and must translate the metadata for the model 
objects. 

If you have multiple data sources in your model that are heterogeneous, publish your 
package with the appropriate function sets so that report authors can leverage them 
while authoring reports. 
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Business Analytics 

Publish Packages 

■ When you publish a package, you can choose to: 

■ publish to the IBM Cognos content store or to a 
network location 

■ externalize query subjects 

■ verify the package 



Cognos. 

software 
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When you publish a package to the IBM Cognos server, you make it available to report 
authors with the appropriate security rights. 

Publishing to the network lets you back up or share all or a portion of your model with 
other metadata modelers. 

You can choose to externalize query subjects to make metadata and data available from 
the underlying data source available for use in other applications. 

To avoid potential problems, select the verify package option in the Publish Wizard to 
check for errors. 
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Business Analytics 

Set Model Version Control 



■ Select the number of versions of the model you want 
to retain on the IBM Cognos server. 



Gognos* 

software 

0 IBM Corporation 



IBM Cognos Connection 



GO Operational Folder/ Package 




) 201 



Model versioning allows for multiple versions of the same model to be maintained in 
IBM Cognos. This allows for changes to the model without immediately affecting 
existing reports. Existing reports will still use the original version of the model allowing 
authors time to repair any damaged reports before the original model expires. 

In the slide example, if the number of model versions to retain is set to 2, and you 
create a report based on the first publish of the package, that report will continue to use 
the first version of the model, even after the second publish. On the third publish 
however, the report will automatically use the latest version. Any reports created or 
modified by report authors will use the most recent version of the model. 
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Demo 1 : Control Model Versions 



Purpose: 

The Sales and Marketing (conformed) package is only required in a 
few regions. Therefore, you will reduce the languages published 
with the project to those required for the regions. You will also 
reduce the function sets published with the package to just the one 
function set required for the database vendor they are using. 

You will also enable model versioning so that authored reports can 
continue to run even though the model has changed. This will allow 
authors some time to fix their reports. You will enable model 
versioning and test the results. 



Components: 

Project: 

Package: 



Framework Manager, Query Studio, Cognos Viewer 

great_outdoors_warehouse 

Sales and Marketing (conformed) 



Task 1. Specify Package Languages and Function List. 



1 . 

2 . 




In Framework Manager, close any projects that may be open, and then open 

the great_outdoors_warehouse project located at C:\Edcognos\B5152\ 
CBIFM-Start Files\Module 24\great_outdoors_warehouse. 

In the Project Viewer pane, expand the Packages folder, and then click Sales 
and Marketing (conformed). 



This package is used prima rily in Germany, Canada and Russia for drill through 
from dimensional data sources. You will limit the languages published with this 
package for the appropriate regions. 



From the Actions menu, point to Package, and then click Specify Package 
Languages. 
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4. In the Selected Languages pane, remove all languages except English. 



German, and Russian using the left pointing green arrow 



button. 



The results appear as follows: 




Note: By default, all languages available in a project will be added to a package 
when you create it. If languages are added to the project after you create 
the package, and you want those languages included in your package, you 
must add them to the package. 



You can also specify package languages for several packages at a time. To do 
this, in the model, click the Packages folder, from the Actions menu, point to 
Package, and then click Specify Package Languages. Also, from the Packages 
sub menu, you can also click Explore Packages to view the contents of each 
package and any object security specified. 
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5. Click OK 

The database vendor for these regions will be using is DB2. You will limit this 
package to the DB2 function set. First you will examine where you can define 
which function set is associated with a data source. 

6. From the Project menu, click Project Function List. 

The results appear as follows: 




The Project Function List dialog box appears. Here you can decide which 
functions sets will appear by default when creating a new package. You can 
choose to include all function sets, or define a function set for each data source 
in the project. If you choose the second option, by default, only defined 
function sets will be selected for your package based on the data sources 
referenced in the package. 
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7. Click Set function list based on the data source type, and then click in the 
Function set column of the go_data_warehouse row. 

A list of database- specific function sets appears. 

8. Click DB2. 

9. Click OK 

When this package was initially created, the setting was to include all function 
sets. You will configure this package appropriate to your data source. 

10. From the Actions menu, point to Package, and then click Specify Package 
Function List. 

1 1 . Remove all function sets except DB2. 

The results appear as follows: 
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12. Click OK. 

Now the next time the Sales and Marketing (conformed) package is published, 
it will be reduced in size since it will contain fewer multilingual metadata and 
fewer function sets. It will only contain what is required by the authors. 

Task 2. Enable model versioning. 

To ensure that authors have time to fix their reports when changes are made to 
the model, you will enable model versioning. 

1 . Right-click the Sales and Marketing (conformed) package, and then click 
Publish Packages. 

2. Under Select publish location, select the Enable model versioning check 
box, and then in the Number of model versions to retain box, type 2. 

3. Select the Delete all previous model versions check box, click Next, click 
Next again, and then clear the Verify the package before publishing check 
box. 

In this case, selecting Delete all previous versions will ensure that you are 
working with a fresh version of the package for demonstration purposes. This 
option can be used to force reports and analyses to use the latest version of the 
model. 

4. Click Publish, and then click Finish. 

Task 3. Create a report based on the Sales and Marketing 

(conformed) package. 

1 . Launch IBM Cognos Connection, log on, launch Query Studio selecting the 
Sales and Marketing (conformed) package. 

2. In the Insert Data menu, expand Sales and Marketing (conformed) > 
Products, and then drag Product to the report. 
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4. 

5. 



From Measures> Sales fact, add Revenue and Planned revenue to the 

report. 



The results appear as follows: 



Product 


Revenue 


Planned revenue 


TrailChef Water Baa 


23,057,141.46 


28,395,176 52 


TrailChef Canteen 


11,333,518.65 


12,561,922.23 


TrailChef Kitchen Kit 


19,535,825.83 


20,626,722.2 


TrailChef Cud 


5,702, 502.7 


6,632,370.18 


TrailChef Cook Bet 


41, 184,274.9 


44,700,935.4 


TrailChef Deluxe Cook Bet 


53,195,154.45 


57,353,831.92 


~ra ^ nr -Umi& 


4^! IRQ R1Q 


4^ 7 f --T7 F.1 



On the toolbar, click Save 
Test, and then click Save. 




, in the Name box, type Model Versioning 



Return to IBM Cognos Connection. 



Task 4. Modify the project, and then re-publish the Sales and 

Marketing (conformed) package. 



Authors have requested that the Product level in the Products regular 
dimension be renamed to Product name to be consistent with the naming 
convention of the parent levels. 

1 . In Framework Manager, in the Project Viewer pane, expand 
go_data_warehouse> Sales and Marketing (conformed) > 

Products > Products . 



2. Rename the Product level to Product name. 

The results appear as follows: 



- ■■ ^ Sales and Marketing (conformed) 


- ^ Products 


_ * 
■i 


\ m Products 




S3 Products 




f S3 Product line 




f S3 Product type 




+■ S3 Product name 
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3 . 

4 . 

5 . 

Task 

1 . 

2 . 

3 . 

Task 

1 . 

2 . 
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Save the project, and then, publish the Sales and Marketing (conformed) 
package. Use the same options as previously chosen, except leave the Delete 
previous model versions check box deselected. 

Click Next, click Next again, and then click Publish. 

A message box appears stating that a previous version of the model already 
exists, and prompting you to add an additional version. 

Click Yes, and then click Finish. 

You now have two versions of the Sales and Marketing (conformed) package 
on the IBM Cognos server. 

5. Run the saved report. 

On the Public Folders page of IBM Cognos Connection, click the Sales 
and Marketing (conformed) folder, and then click Run with options - 

Model Versioning Test K. . 

Click Run. 

The report mns and opens in Cognos Viewer without issue. This report has run 
against the original version of the package, which is different from the package 
you just published. 

Return to IBM Cognos Connection. 

6. Re-publish the Sales and Marketing (conformed) 
package and run the saved report. 

In Framework Manger, re-publish the Sales and Marketing (conformed) 

package using the same options in the Publish Wizard. 

A message box appears stating that two model versions of the model already 
exist, that the maximum allowable is two, and that publishing will overwrite one 
of the versions. The message also prompts you to continue with the publish. 

Click Yes, and then click Finish. 
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3. In IBM Cognos Connection, re-run the report as in the previous task. 

An error message appears. 

4. Click Details. 

The message indicates that 

QE-DEF-0359 The query contains a reference to at least one object '[Sales and 
Marketing (conformed)] . [Products] . [Products] . [Product] ' that does not exist. 

5. Click OK, and then click Cancel. 

Task 7. Open the saved report in Query Studio. 

1 . Click the Model Versioning Test report to open it in Query Studio. 

A message appears indicating that a more recent version of the package exists 
and that if you want to complete the update, you must save the report. 

2. Click OK 



The results appear as follows: 



Revenue 


Planned revenue 


4,686,775,768.35 


4,9 19,342,361.94 



The Product level column is no longer valid and does not appear in the report. 
You will need to re- add this column to the report to repair it. 
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3. Under Menu, click Insert Data, expand Sales and Marketing 

(conformed) >Products, and then drag Product name to the report as the 
first column. 

The results appear as follows: 



Product name 


Revenue 


Planned revenue 


TrailChef Water Baa 


23,057,141.46 


23,395,176.52 


TrailChef Canteen 


11,333,518.65 


12, 561,922.23 


TrailChef Kitchen Kit 


19,535,825.83 


20,626,722.2 


TrailChef Cud 


5,702,502.7 


6,632,370.13 


TrailChef Cook Set 


41, 184,274.9 


44,700,935.4 


TrailChef Deluxe Cook Set 


53,195,154.45 


57,353,331.92 


~railr^kc.-^ Cir«.r c. — 1 => ■=. 


IffG S1G 


^ fl-37 1 TT £1 



4. On the toolbar, click Save, and then return to IBM Cognos Connection. 

Results: 

You reduced the number of languages and function sets published 
with the Sales and Marketing (conformed) package, and enabled and 
tested model versioning to ensure reports can continue to run even 
though the model may change. 
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Business Analytics 

Nest Packages 

■ When you create nested packages, you create a 
master package that is based on other packages. 



Framework Manager Model Packages 



Master Package 




North America 




/ 


t 


\ 


Mexico 


United States 


Canada 





Cognos* 

software 
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Use nested packages to reuse model information. 

Nested packages save time, are easier to maintain, and let you publish only the master 
package to make all referenced packages available to report authors. 
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Demo 2: Nest Packages 



Purpose: 

One of the quality assurance teams that tests your packages wants 
to combine the GO Data Warehouse (query) and GO Data 
Warehouse (analysis) packages into one package for testing and 
comparison purposes. You will use a nested package to fulfill this 
request. 



Components: Framework Manager, Business Insight Advanced 



Project: 



great_outdoors_warehouse 



Package: GO Data Warehouse (query and analysis) 

Task 1 . Create a nested package. 

1. In Framework Manager, create a new package called GO Data Warehouse 
(query and analysis), and then click Next. 

2. In the Define Objects dialog box, select Using existing packages. 

3. Click the GO Data Warehouse (analysis) and the GO Data Warehouse 
(query) packages 

The results appear as follows: 





v" 

✓ 

X 


GO Data Warehouse (analysis) 
GO Data VVanehouse (query) 

T Sales and Marketing (conformed) 



4. Click Next, and then click Finish. 

5. Click Yes, deselect Enable model versioning, and then click Next twice 

6. Clear the Verify the package before publishing check box, click Publish, 
and then click Finish. 

7. Save the project. 
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Task 2. View the package in Business Insight Advanced. 

1. In IBM Cognos Connection, ensure you are in Public Folders, and then 
launch Business Insight Advanced selecting the GO Data Warehouse 
(query and analysis) package for a List report. 

The results appear as follows: 

T [|§] GO Data Warehouse (query and analysis) 
k HP; (analysis) 

& Q Sales and Marketing (analysis) 

& d Rrianpe (analysis) 
t# Ci HR (query ) 

t- Q Sales and Marketing (query) 

& Ci Finance (query) 

& fj Filters 

Quality assurance staff now has access to both the query and analysis views of 
the metadata, and can quickly perform tests on either view without switching 
packages. 

2. Close IBM Cognos Connection, do not save changes, and then, in 

Framework Manager, close the great_outdoors_warehouse project. 

Results: 

By nesting existing packages, you created a package that re-used 
two different presentation views of the metadata in the project for 
use in comparative testing by the quality assurance team. 
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Business Analytics 

Summary 

■ You should now be able to: 

■ specify package languages and function sets 

■ control model versioning 

■ nest packages 



Ooanos. 

software 
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Manager Modeling Techniques 



IBM Cognos BI 




Business Analytics 
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Business Analytics ^==^~i 

Objectives 

■ At the end of this module, you should be able to: 

■ leverage a user defined function 

■ set the order of operations in a model calculation 

■ externalize query subjects 

■ prepare IBM Cognos content for use as a data 
source in Transformer 

■ create query sets 

Cognos. 

software 
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Business Analytics 

Leveraging User-Defined Functions 

■ User-defined functions: 

■ return a single value per request (per row) 

■ can be imported or referenced in the SQL of the 
query subject definition 

Planned Revenue Calculation 

|Calc_Planned_Revenue([gosales].[ORDER_DETAILS]. [QUANTITY], 
[gosales].[C RDER_DETAILS].[UNIT_PRICE]) 



User Defined Function Reference 

Cognos. 

software 
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When you reference a user-defined function in a query subject, it will be represented as 
a query item and will return a value for each row of data as calculated by the function. 

If you wished to reference the user-defined function in the slide example in the SQL of 
the query subject rather than importing it into the project, the syntax would appears as 
shown below: 

select 



ORDER_DETAILS.ORDER_DETAIL_CODE, 



dbo.Calc_Planned_Revenue(ORDER_DETAILS.QUANTITY,ORDER_D 
ETAILS.UNIT_PRICE) as "Planned Revenue" 

from [GOS ALES] . ORDER_DETAILS 
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Business Analytics 

Examine the Regular Aggregate Property 

■ The Regular Aggregate property has the following 
settings: 

■ automatic 

■ average 

■ calculated (applies only to standalone calculations) 

■ count 

■ maximum 

■ minimum 

■ sum 

Cognos. 

software 
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The above are options for relational data source query items with their U sage property 
set to Fact. 

The setting made in the model will become the default behavior in the reporting 
studios. 
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Business Analytics 

Set Order of Operations for Model 
Calculations 



■ If you have a model calculation (A*B) set to 
calculated, where A and B are set to sum: 

■ the behavior in Query Studio and Report Studio will 
be to summarize first and then calculate 




Property Set 
to Sum 




Regular Aggregate 
Property Set 
to Calculated 

Cognos. 

software 

©2010 IBM Corporation 



The Calculated setting in the Regular Aggregate property controls the order of 
operations in standalone model calculations. 
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Demo 1 : Set Order of Operations for a Model Calculation 



Purpose: 

Authors would like to see margin values in their reports. Currently a 
margin query item calculation is available to them, but it is 
performing the margin calculation first and then aggregating the 
values, which is returning undesired results. They would like to see 
the underlying values aggregated first and then perform the margin 
calculation. 

To accomplish this, you will create a stand-alone margin calculation, 
since this type of operation is only supported for stand-alone 
calculations, and set the Regular Aggregate property accordingly. 



Components: Framework Manager, Query Studio 

Project: GO Operational 

Package: GO Operational (query) 

Task 1 . Test existing Margin query item. 

1. Launch Framework Manager, and then open the GO Operational project 
located at C:\Edcognos\B5152\CBIFM-Start Files \ Appendix A\GO 
Operational. 

2. Expand Foundation Objects View, expand gosales namespace, and then 
expand Sales Fact. 
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3. Select and test the following items: 

• Revenue 

• Gross Profit 

• Margin 



The results appear as follows: 



T est results 




Revenue 


Gross Profit 


Margin 






8624.64 


4625.82 


0.53638093796378 






941 1.6 


4840.12 


0.51427174975562 






18032.22 


5072.22 


0.28128849717007 






fifiqn !-! 





n 2951 1 RCR1 TT-m 



These are un-aggregated values. The Margin calculation is Gross Profit divided 
by Revenue. The margin values are correct. You will now test the items with 
Auto Sum enabled. 

4. Select Auto Sum, and then click Test Sample. 

The results appear as follows: 



Test results 





Revenue 


Gross Profit 


Margin 






4686775768.85 


1924834994.68 


194030.904167937 













Notice the margin value is not what is expected. All the detail records are being 
calculated first and then aggregated. The value shown in the Margin column is 
the sum of all the margin values seen in the un-aggregated result set in the 
previous test. The expected result would be the Gross Profit value above 
divided by the Revenue value above for a margin of 0.41 . 

5. Click Close. 
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Task 2. Create a stand-alone Margin calculation and set its 

Regular Aggregate property. 

1. Double-click Sales Fact, right-click Margin, and then click Convert to Stand- 
alone Calculation. 

The Margin query item will no longer be required in the Sales Fact query 
subject. Setting the order of operations to aggregate first and then calculate is 
only valid for stand-alone calculations. The calculation cannot be restricted by 
the scope of a query subject container. 

2. Delete the Margin query item. 

A message appears indicating that the Margin query item in the Sales Fact query 
subject in the Consolidation View will be invalidated. You will also delete that 
query item in the next few steps. 

3. Click OK, and then click OK again. 

The stand-alone Margin calculation appears at the bottom of the gosales 
namespace. 

4. In the Consolidation View, expand Sales Fact and delete the Margin query 
item. 

A message appears saying that the Margin measure in the Sales Fact regular 
dimension in the Dimensional View namespace will be invalidated. You will 
delete this object in the next few steps. 

5. Click OK 

6. Expand Dimensional View>Sales Fact, and then delete the Margin query 
item. 

Note: If you want to make the Margin calculation available for your analysis 
package, simply make the stand-alone calculation available in that 
package. 
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Task 3. Change the Regular Aggregate property for the Margin 

calculation and test in Query Studio. 

1 . In the Project Viewer, select the stand-alone Margin calculation, and then in 
the Properties pane, change the Regular Aggregate property to Calculated. 

2. Move the stand-alone Margin calculation to the Sales (query) namespace in 

the GO Operational Sales (query) namespace, in the Presentation View. 

3. Arrange the stand-alone Margin calculation as shown below: 



Presentation View 



GO Operational Sales (query) 



- Sales (query) 

2j|| Sales Fact 
^ Margin 

Branch by Location 
Order Codes 
|gg Order Method 
[Products 

nnn Pof-ailar l~.‘i a I aeJnn 



4. Publish the GO Operation (query) package. 

5. Launch IBM Cognos Connection, log on, and then launch Query Studio 
selecting the GO Operational (query) package. 

6. In the Insert Data menu, expand Sales (query)>Sales Fact, and then select 
the following items: 

• Revenue 

• Gross Profit 



Margin 
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7. Drag the selected items onto the report. 



The results appear as follows: 



Revenue 


Gross Profit 


Margin 


$4,686, 775,768. 85 


$1,924,834,994.68 


41% 





Notice the aggregated Margin value is now correct. The detail values for Gross 
Profit and Revenue are aggregated first and then calculated. This value has been 
formatted as a percentage in Framework Manager. If it had not been formatted, 
it would have appeared as 0.41069491898314. 

8. Close your browser without saving the report. 

9. In Framework Manger, save and close the project. 

Results: 

You created a stand-alone margin calculation and set the Regular 
Aggregate property to Calculated to perform an aggregation before 
your calculation. 
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Business Analytics 

Externalize Query Subjects 

■ Framework Manager can export model metadata/ 
data in various formats for use in other applications. 




Coqnos. 



m 



software 
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When publishing a package, you can externalize query subjects so that you can leverage 
them as data sources in other applications. For IBM Cognos Business Intelligence 
Transformer, we recommend that you access this content through IBM Cognos 
reports or packages. 

To externalize a query subject, you must perform the following tasks: 

1. Set the Externalize Method property for the query subject. 

2. Use the Publish Package wizard to generate the required files. 
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Demo 2: Externalize Query Subjects to CSV Format 



Component: Framework Manager 

Project: great_outdoors_sales 

Purpose: 

A request has come in to make data produced by some of your 
query subjects available for use in other applications. To fulfill this 
request, you will externalize query subjects from your model to tab 
delimited files. They would like data for time, products, and sales 
targets. The sales targets data should be summarized at the month 
level and the product data should only go down to the product type 
level. 



Task 1 . Create model query subjects and set properties to 

externalize query subjects. 

1. In Framework Manager, open the great_outdoors_sales project located at 
C:\Edcognos\B5152\CBIFM-Start Files \Appendix_A\ 

gre at_outdoors_s ales . 

There is already one query subject that can be leveraged. 

2. Expand go_sales>Business view. 

3. Select Time dimension, and then in the Properties pane, change the 

Externalize Method property to tab. 

Naming conventions have been applied to this object and some other modeling 
techniques. This is a good candidate to provide time data when you externalize 
your query subjects. 
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You will now create model query subjects to fulfill the requirements of the 
request made. Sales targets are at the product line level not the product level. So 
you will create a Product Type (externalize) model query subject that only 
contains query items down to the product line level. You will also create a Sales 
Target (externalize) model query subject that only contains the month key, 
product type key, and sales target values so that you can aggregate the values at 
the month level and product type level. 

4. Expand Database view>gosales. 

5. In the Model query subjects (gosales) folder, create a new model query 
subject called Product Type (externalize). 

6. In the Available Model Objects pane, expand Database view>gosales> 
Model query subjects (gosales) >Product, and then drag the following items 
to the Query Items and Calculations pane: 

• Product line code 

• Product line 

• Product type code 

• Product type 

7. Click OK. 

8. In the Model query subjects (gosales) folder, create a new model query 
subject called Sales Target (externalize). 

9. In the Available Model Objects pane, expand Database view>gosales> 
Model query subjects (gosales) > Sales target, and then drag the following 
items to the Query Items and Calculations pane: 

• Month key 

• Product type code 

• Sales target 
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10. Click OK. 

11. In the Project Viewer, select the Sales Target (externalize) and Product 
Type (externalize) model query subjects. 

12. If necessary, in the Properties pane, scroll to the right until you see the 
Externalize Method property and then set it to tab for both query subjects. 

To ensure the sales target values are aggregated and you get only unique 
product type values, you must set the Externalize Auto Summary property for 
the Sales Target (externalize) and Product Type (externalize) model query 
subjects. This is tme for product types since the underlying model query subject 
goes down to the product level. This causes repeating values at the product type 
level. 

13. In the Properties pane, change the property setting for Externalize Auto 
Summary for both objects to true. 

Task 2. Create a package and externalize the model query 

subjects. 

1 . Right-click the Packages folder, point to Create, and then click Package. 

2. In the Name box, type Externalize Query Subjects, and then click Next. 

3. Select the check mark beside the go_sales namespace. 

All items are now deselected. 
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4 . 
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Click the X beside the model query subjects you set to externalize in the 
previous task. 

• Product Type (externalize) 

• Sales Target (externalize) 

• Business view > Time dimension 
The results appear as follows: 





I 1+ hi X ’ 

! 1 + H x ’ 

- X - ^ 


ij'x'F 

k- x F 
ill x j- 
±\"\ l T 

IS go 
IS go 
j Busine 


Ejfjg Product {by brand) 

H Order method 
m Product 

Ejfjg Product Type (externalize) 
Sales Target ;extemalize; 
retailers 
hr 

ss view 



Inventory 
Product forecast 
Returned Items 
Sales 

Sales target 
Branch 
Order 

Order method 
Product 

Product (by brand) 

Retailer 
Retailer site 
Return reason 
Sales staff 
Time dimension 

Time dimension (close date) 

These items are now selected and will be the only items included in the package. 
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5. Click Finish, and then click Yes to opening the Publish Package wizard. 

When publishing, you have to choose to publish to the IBM Cognos content 
store (IBM Cognos Connection) or to a Network location. You will choose 
Network location in this demo, because you do not want this package to be 
available in IBM Cognos Connection. 

6. Deselect Enable model versioning, click Location on the network, and then 
beside the Network location box, click Browse. 

7. Navigate to C:\Edcognos\B5152\Course_Project. 

8. Create a new folder called Externalized Query Subjects Model, select it, and 
then click OK 

9. Click Next, and then click Next again. 

10. Select Generate the files for externalized query subjects, click Browse and 
then navigate to C:\Edcognos\B5152\Course_Project and create a folder 
called Modeling Techniques. 

1 1 . Click OK, clear the Verify the model before publishing check box, and then 
click Publish. 



The results appear as follows: 



Query Subject ID 


M ethod 


Path 





[gosales]. [S ales T arget (externalize)] tab C: \E dcognos\B 51 52\Course _Project\M odeling echniques\gosales S a 

[B usiness view], [T ime dimension] tab C: \E dcognos\B 51 52\Course_Project\M odeling T echniques\B usiness vii 

[gosales], [Product type (externalize)] tab C: \E dcognos\B 51 5 2 \ C o u r s e_ P r o j e c t \ M odeling echniques\gosales_Prr 



12. Click Finish. 
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Task 3. Examine the generated files. 

1 . Open Windows Explorer, and then navigate to 

C:\Edcognos\B5152\Course_Project\Modeling Techniques. 

The right pane of Windows Explorer appears as shown below: 



Address |G C : \Edcognos\B5 1 52\Course_Pro ject\Modeling T echniques 



Name A | 


bize 


Type 


] Business view_Time dimension. . . 


269 KB 


TAB File 


] gosales_Product type (extern. . . 


2 KB 


TAB File 


] gosales_5ales Target (extern. . . 


34 KB 


TAB File 



The publishing operation, based on the choices we made in the Publish Package 
wizard, has generated the tab files and the Framework Manager project files, 
located under Course_Project. The name of the tab files are based on the name 
of the namespace that contains the externalized query subject and the name of 
the externalized query subject. 

2. Double-click gosales_Product Type (externalize). tab. 
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3. Select Select the program from a list, select Notepad, and then click OK 
The results appear as follows: 




The first row contains tab delimited column headings and the remaining rows 
contain tab delimited data. Only unique values are returned for product types 
since the data set was aggregated. 

4. Close Notepad, and then open the gosales_Sales Target (externalize). tab 

file to view it. 

Again, the first row contains tab delimited column headings and the remaining 
rows contain tab delimited data. The sales target values are aggregated to the 
month and product type levels. 

5. Close Notepad, and then examine the data in the Business view_Time 
dimension.tab. 

This file also contains column headers, and all the data from the time 
dimension. 
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6. Close Notepad. 

7. In Framework Manager, save the project. 

Results: 

You externalized query subjects from your model in tab delimited 
file format so that the data retrieved can be leveraged in other 
applications. 
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Business Analytics ^==^~i 

IBM Cog nos as a Data Source for Transformer 

■ IBM Cognos Transformer can directly use IBM Cognos 
content as a data source: 



-► 



©2010 IBM Corporation 



reports 

packages 



IBM Cognos 




Package 

Reports 










Package 






Transformer is the IBM Cognos OLAP modeling component used to model and build 
PowerCubes. 

As a modeler, you can make metadata available for use in Transformer. For data to be 
used in dimensions, you need to make items available in your dimension query subjects 
to act as category codes (business keys) and captions. The business key values should 
be unique across all levels in the dimension. For fact data, you need to make items 
available in your fact query subjects that Transformer will use as measures and as the 
keys that allow the measures to be related to the dimensions. For example, if your 
measures will relate to the Product dimension, you will need to make the Product Key 
available in your fact query subject. 
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Once the appropriate metadata is made available, Transformer modelers can access the 
individual dimension information and measure information (each accessed as a separate 
data source) through IBM Cognos reports, or directly from metadata in the package. 

Once a Transformer modeler has created a PowerCube, it can be published as a 
package in IBM Cognos for use as a multidimensional data source. 
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Business Analytics 



Create Query Sets 



Sales 


1 1 


Order 


Staff 


U union 


Method 



Staff 

name 


Order 

Year 


Revenue 


Jung-ho 

Choi 


2006 


880393.32 


Maureen 

Hoffman 


2006 


326278.56 


Elsbeth 

Wiesinger 


2006 


1268132.22 



♦ 



Order 

Method 



Email 



Special 



Sales visit 



Mail 



Fax 



Telephone 



Web 



Order 

Year 



2006 



2006 



2006 



2006 



2006 



2006 



2006 



Revenue 



11883050.12 



1009761.02 



17319761.02 



1941161.00 



3628271.46 



18202550.86 



20282832.18 



All the rows of two query 
subjects. Values are not 
duplicated. 



<query subject 



name> 


* 


Order 

Method 


Order 

Year 


Revenue 


Email 


2006 


11883050.12 


Special 


2006 


1009761.02 


Sales visit 


2006 


17319761.02 


Mail 


2006 


1941161.00 


Fax 


2006 


3628271.46 


Telephone 


2006 


18202550.86 


Web 


2006 


20282832.18 


Jung-ho 

Choi 


2006 


880393.32 


Maureen 

Hoffman 


2006 


326278.56 


Elsbeth 

Wiesinger 


2006 


1268132.22 
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You define a query set to merge, compare, or equate similar data from different 
sources. Query sets are useful when modeling data from disparate systems, or when the 
desired result is not directly available through a typical query of the data source. 

A query set can be defined using the set operations of union, intersect, or except. 
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Purpose: 

Report authors must provide reports that include data values from 
both the Staff name and Order method query items in a single 
column, to allow easier comparison. They can achieve this result in 
Report Studio for a given report; however, they must repeat this 
operation for multiple reports that share this requirement. They 
would like to avoid this, and have this functionality included as part 
of the model. To meet this requirement, you will create a query set 
using a union operation that will combine the values from these two 
query items into a single column. 



Component: Framework Manager 



Project: 



great_outdoors_sales 



Task 1 . Create the first query subject. 

1. In Framework Manger, in the Project Viewer, under go_sales>Database 
View>gosales>Model query subjects (gosales), select the following items: 



Query Subject 

Order method 
Sales 



Query Item 
Order method 
Order date 
Revenue 



Right-click the Order method query item, and then click Merge in New 
Query Subject. 

When prompted to create relationships, click No, rename the new query subject 

to Order Methods Revenue. 

Instead of reporting against order dates, authors would like the comparison by 
year. You will use the Year function to extract the year from Order date. 
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4. Expand Order Methods Revenue, double-click click Order date, and then 
edit the Expression definition so that it appears as follows: 

Year( [gosales] . [Sales] . [Order date] ) 

5. Click OK, rename Order date to Order year. 

For testing purposes, you will create a filter that will narrow the scope of the 
result set to the year 2006. 

6. Double-click Order Methods Revenue, click the Filters tab, in the bottom 
right corner, click Add, and then in the Name box, type Order Year Filter. 

7. In the Available Components pane, double-click Order year to add it to the 

Expression definition pane. 

8. At the end of the expression, type = 2006 , 

The results appear as follows: 

[gosales] . [Order Methods Revenue] . [Order year] = 2006 

9. Click OK, and then click OK again. 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



A-25 




IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Task 2. Create the second query subject. 

1. In the Project Viewer, expand gohr>Model query subjects (gohr). 

2. Select the following items from both the gosales and gohr namespaces: 



Query Subject 


Query Item 


Sales staff 


Staff name 


Sales 


Order date 
Revenue 



3. Right-click Staff name, click Merge in New Query Subject, and then click 
No to creating relationships. 

4. Rename the new query subject to Sales Staff Revenue, move it to the Model 
query subjects (gohr) folder, and then expand the Sales Staff Revenue query 
subject. 

5. Double-click Order date, and then edit the Expression definition so that it 
appears as follows: 

Year( [gosales] . [Sales] . [Order date]) 

6. Click OK, rename Order date to Order year, and then click Enter. 

Again, for testing purposes, you will create a filter that will narrow the scope of 
the result set to the year 2006. 

7. Double click Sales Staff Revenue, click the Filters tab, in the bottom right 
corner, click Add, and then in the Name box, type Order Year Filter. 

8. Double-click Order year to add it to the Expression definition pane. 

9. At the end of the expression, type = 2006 , 

The results appear as follows: 

[gohr] . [Sales Staff Revenue] . [Order year] = 2006 

10. Click OK, and then click OK again. 
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Task 3. Create the query set. 



1 . 

2 . 

3. 

4. 



5. 

6 . 



Click Order Methods Revenue, and then Ctrl+click Sales Staff Revenue. 



From the Actions menu, click Define Query Set. 

In the N ame box, type Order Methods / Sales Staff Revenue for 2006. 

The default set operation is to Union the two query subjects. This is the 
selection you want. 

Click OK, and then expand the Order Methods/Sales Staff Revenue for 

2006 query subject. 

There are only 3 query items in the query subject. By default, Framework 
Manager has changed the Usage property of the Order year query item to Fact. 
You will change this. 

Under Order Methods/Sales Staff Revenue for 2006, click Order year, and 

then in the Properties pane, change the Usage property to Attribute. 

Test the Order Methods/Sales Staff Revenue for 2006 query subject. 



The results appear as follows: 



i esr iesuil 




Order method 


Order year 


Revenue 


Web 


2000 


iasoa 




Web 


2m 


09253 




Nathalie Benoit 


2 m 


111203.4 




.Abram Ruiz 


2 m 


0132.35 




James Ross-Hythe 


2 m 


4546 04 




Web 


2 m 


15317.55 




Web 


2aao 


0999.52 




Wilbur Baldock 


2000 


3034.4 




P.fl-jfl-.ilr-lc. 1 mirlor "■ n ~ ! £ TO PT 



Notice that the Order method column contains values based on both the 
original Order method and Staff name query subjects. This is a result of the 
Union operation performed. You will now rename the query item appropriately 
and implement a technique that will sort the values in the column. 
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Task 4. Rename query item and add a sort key query item to 

the original query subjects. 

1 . Click Close, and then rename the Order method query item to Order 
methods / Staff names. 

2. Double-click the Order Methods Revenue query subject, and then, in the 
bottom right corner, click Add. 

3. In the Name box, type Sort Key, in the Expression definition box, type ’A', 
and then click OK. 

4. Click OK again. 

5. Repeat steps 2 to 4 to create a query item called Sort Key in the Sales Staff 
Revenue query subject that has the following expression: 'B f . 
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Double-click the Order Methods / Sales Staff Revenue for 2006 query 
subject, and then click OK 

The Sort Key query item appears in the Order Methods / Sales Staff Revenue 
for 2006 query subject. 

Test the Order Methods/Sales Staff Revenue for 2006 with Auto Sum 
enabled. 



The results appear as follows: 





Test results 




Order methods/Staff names 


Order year 


Revenue 


Sort Key 




Aaltje Hansen 


2006 


8503567.85 


B 




Abram Ruiz 


2006 


10450641.88 


B 




Adda Heijman 


2006 


8641892.44 


B 






Adriaantje Haanraads 


2006 


10210608.27 


B 






Agatha Reyes 


2006 


7378224.86 


B 






Agnelo Chavez 


2006 


81 3261 8 


B 






Agnes Ramos 


2006 


7355606.6 


B 






Aidan Chaplin 


2006 


4873573.41 


B 






Aiko Watanabe 


2006 


13789738.8 


B 






Aila Forssell 


2006 


11234064.27 


B 






Aimi T anaka 


2006 


3525878.21 


B 






Akemi T akahashi 


2006 


16197823.54 


B 






Akemi Yamada 


2006 


13167128.19 


B 






Akira Hashimoto 


2006 


1181719.82 


B 






Alberto Pera 


2006 


6529169.45 


B 






Alessandra T orta 


2006 


8881435.6 


B 






Alexandre Pereira 


2006 


10870383.67 


B 






■I* iii. 




J J 1“ . — 1 





The Order methods / Staff names column appears with values sorted based on 
the presence of the Sort Key column. 

8. Click OK, close Framework Manager, and then click Yes to save changes. 

Results: 

You created a query set that unions the values from the Staff name 
and Order method query items into a single column. 



6. 



7. 
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Business Analytics 

Summary 

■ You should now be able to: 

■ leverage a user defined function 

■ set the order of operations in a model calculation 

■ externalize query subjects 

■ prepare IBM Cognos content for use as a data 
source in Transformer 

■ create query sets 
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Business Analytics 



Objectives 

■ At the end of this module, you should be able to: 

■ customize metadata for a multilingual audience 








Cognos* 

software 
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Business Analytics 



Framework Manager Workflow 



Framework Manager 



Create 

Project 




Import 

Metadata 



Prepare 

Metadata 



Model 

Metadata for 
Reporting 



Publish 



Set 

Security 



I 



Create and 
Manage 
Packages 



Data 

Sources 



Content 

Store 



Report Studio 
Query Studio 
Analysis Studio 
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This module describes modifying language properties to ensure that metadata is 
available in all languages required for authors. 
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DATA 



Business Analytics 

Modify Language Properties 

■ Each model object has three Language properties: 

■ Name 

■ Description 

■ Screen Tip 

■ Language properties can be modified: 

■ manually in the project 

■ by exporting/importing a translation file 

Cognos. 

software 
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You can translate the multilingual text properties associated with metadata; names, 
descriptions, and screen tips. Only the metadata is translated. You can then publish 
your package to make the translated metadata available to authors. To do this: 

• define the languages to be included in the project 

• modify the Language properties manually or export the multilingual text 
properties to a translation file, which translators use to input the correct text for 
each language. Once translation is complete, import the file to update the 
Language properties with the translated strings. 

• specify the languages you want to include in your package (they must be available 
at the project level first) and then publish the metadata. 
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Demo 1 : Apply Multilingual Query Item Properties 



Purpose: 

You want to ensure that users working in languages other than 
English can easily use the GO Operational model to create reports. 
You will add French support to the project, translate a query item 
name and description, publish the package with both French and 
English metadata, and test the package in Report Studio. 



Component: Framework Manager 



Project: GO Operational 



Task 1 . Add languages to the project. 




2 . 

3. 



In Framework Manager, close any projects that may be open, and then open 

the GO Operational project located at C:\Edcognos\B5152\CBIFM-Start 
Files\Appendix B\GO Operational. 

This project has had any additional languages removed from the model in order 
to perform this demonstration. 



From the Project menu, point to Languages, and then click Define 
Languages. 



In the Available languages box, click French, click Add 

OK 




and then click 



A warning message appears indicating that the languages will be added to every 
text property of every object. 

4. Click OK 



B-6 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 







MODEL MULTILINGUAL DATA 



Task 2. Add a French name and description. 

1. Expand GO Operational Model> Consolidation View>Products, and then 
click the Product Type query item. 

2. At the top of the Properties window, click the Language tab. 

The results appear as follows: 

Properties 



Properties Language 





Name 


Description 


Screen Tip 


English tv 


French TV 


English TV 


French TV 


English TV 


French 


flf Product Type 


Product Type 


■Jr) Product T... 











Notice that for the Name, Description and Screen Tip properties, you now see 
one entry for each language. However, all entries are in English initially, the 
project's design language. 

The description and screen tip are blank for the French columns. You cannot 
add a French value for either the description or screen tip until you supply a 
value for the primary language (English) . 

3. In the Description row under English, type Product Type identifies a set of 
related products, and then press Enter. 

You can now add a French value, because you have supplied a value for the 
primary language. 

4. In the Description row under French, delete the existing text, type Type de 
produit and then press Enter. 

5. In the Name row under French, type Type de produit. 

6. Save the project. 
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Task 3. Publish the model in both English and French, and 

create a report. 

1. Under Packages, select the GO Operational package, and then, from the 
Actions menu, click Package> Specify Package Languages. 

2. Under Available Project Languages, select French, click Add, and then click 

OK 

3. Publish the GO Operational package. 

Note: In the Properties pane for packages, you can also translate the package 
name and any descriptions or tool tips required by end users. 

4. Launch IBM Cognos Connection, log on, and then open Report Studio 
selecting the GO Operational package. 

5. Click Create new, and then double-click List. 

6. In the Insertable Objects pane, expand Presentation View>GO 
Operational Sales (query) > Sales (query) >Products. 

7. Right-click Product Type, and then click Properties. 

In the Description row of the Properties dialog box, the text appears that you 
specified for the Description property in Task 2. 

8. Click Close, and then close Report Studio without saving. 

Task 4. Create a report to verify the French query item name 

and description. 

1 . In IBM Cognos Connection, click My Home, click My Area Options in the 

top right corner, and then click My Preferences. 

2. Under Regional options, change the Content language setting to Use the 
following language, in the list click French, and then click OK 
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3. Launch Report Studio selecting the (fr) GO Operational package. 

4. Create a new List report. 

Report Studio opens with the metadata from the (fr) GO Operational model 
appearing in the Insertable Objects pane. Notice that all items are prefixed with 
(fr). This indicates that you are now in the French version of the model but you 
have not yet translated all of your metadata tides and properties. 

5. Expand (fr) Presentation View>(fr) GO Operational Sales (query) > (fr) 
Sales (query) >(fr) Products. 

Notice that Type de produit stands out among the (fr) -prefixed query item 
names. 

6. Right-click Type de Produit, and then click Properties. 

In the Description row of the Properties dialog box, the text appears that you 
specified for the Description property in Task 2. 

7. Click Close, and then close Report Studio. 

8. In IBM Cognos Connection, click My Area Options in the top right corner, 
and then click My Preferences. 

9. Under Regional options and Content language, click Use the default 
language, and then click OK. 

Results: 

You added French support to the project, translated a query item 
name and description, published the package in both French and 
English, and tested the package in Report Studio. 
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Demo 2: Apply Multilingual Translation Files 



Purpose: 

You want to ensure that users working in languages other than 
English can easily use the GO Operational model to create reports. 
To this end, you will enhance the model by exporting a translation 
file and modifying it so that it contains French and English strings. 
You will then import this file back into the model and view the 
results. 



Component: Framework Manager 



Project: 



GO Operational 



Task 1 . Export metadata to a CSV file for translation. 

1 . In Framework Manager, from the Project menu, point to Languages, and 
then click Export Translation File. 



2. Under the Project Languages pane, Ctrl+click French so that both English 




to move them to the 




and French are selected, and then click Add 

Languages to be exported pane. 



3. Next to the Export languages to this file box, click Browse 

4. In the Save as type box, click CSV (comma delimited) (*.csv). 

5. Click Desktop in the left pane, in the File name box, type 
GO_Application_LOC.csv, and then click Save. 

6. Click OK 

A message appears, indicating that the language strings were successfully 
exported. 
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7. Click OK 

8. On the Windows Desktop, double-click GO_Application_LOC.csv to open 
it in Microsoft Excel, and then expand the first two columns. 

Notice that each column represents a given language; in this case, English and 
French. These are based on the language selections you made when you 
exported the model languages in previous steps. 

9. In the second column of row 18, change the French value of (fr) Branch City 
to Ville de Succursale. 



10. In the second column of row 21, change the French value of (fr) Branch 
Country to Pays de Succursale. 

1 1 . Save the file, click Yes to the warning message and close Excel. 



Task 2. Import a CSV file that contains translated strings. 



1 . 

2 . 

3. 

4. 

5. 



In Framework Manager, from the Project menu, point to Languages, and 
then click Import Translation File. 



In the Project Languages pane, click French, and then, below Translate 




into, click Add — I to add it to the Translate into pane. 

Next to the Import translation table from this file box, click Browse. 

In the Files of type box, click CSV (comma delimited) (*.csv), and then, if 
necessary, click Desktop, and then double-click GO_Application_LOC.csv 

Click OK 



A message appears indicating that the import was successful and the details of 
the properties that were updated in the model objects. All objects that reference 
the translated metadata are updated such as items in the Foundation Objects 
View, the Consolidation View and the Dimensional View. 
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6. Click OK 

7. In the Consolidation View, expand Branch by Location, and then click 
Branch Country. 

In the Properties pane, notice that the French value for the Name property of 
Branch Country reflects the change that you made to the translation file. 

8. Click Branch City. 

Again, in the Properties pane, notice that the French value for the Name 
property of the query item is as expected. 

9. Save and close the project. 

Results: 

You enhanced the GO Operational model by exporting the model 
languages to a translation file. You modified this file so that it 
contained French and English strings. You imported the file back 
into the model and viewed the results. Users can now begin to work 
with the GO Operational model in languages other than English. 
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MODEL MULTILINGUAL DATA 



Business Analytics 

Summary 

■ You should now be able to: 

■ customize metadata for a multilingual audience 




Cognos* 

software 

©2010 IBM Corporation 
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Additional Resources 



IBM Cognos BI 




Business Analytics 
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ADDITIONAL RESOURCES 



IBM Cognos provides a resource for users and developers to guide them through the 
tasks and processes of maximizing the IBM Cognos business intelligence tools. This 
resource is the Cognos Proven Practices documentation repository. 

Created by Cognos experts from real-life customer experiences, Cognos Proven 
Practices is your source for rich technical information that is tried, tested, and proven 
to help you succeed with Cognos products in your specific technology environment. 

The Cognos Proven Practices documentation repository is updated regularly. Access 
the repository through IBM Developerworks. The Cognos specific URL is: 
http:/ /www.ibm.com/ developerworks/ data/library/ cognos/ 
cognosprovenpractices.html 

In particular, the following topics and documents augment this course: 

• Time Period Analysis 

http:/ /www.ibm.com/ developerworks/ data/library/ cognos/page352.html 
This document describes a technique for Dimensionally Modeled Relational data 
sources that will allow for relative time period analysis within crosstabs. This 
technique focuses on developing period-to-date aggregates. 

• Durable Models 

http: / / www.ibm.com/ developerworks / data/library/ cognos / page60.html 
This document will point out some concepts which will help you to create models 
that will be as flexible as possible and help survive changes to the requirements, 
http:/ /www.ibm.com/ developerworks/ data/library/ cognos/ modeling/ design 
/ page496.html 

This document describes a process to ensure that changes to a Framework Manager 
model's published packages and corresponding content in the Content Store will 
continue to function in unison even as changes are made to the model. 

Check this valuable resource regularly. 
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